FreeBSD is not currently an officially supported Operating System on Framework Computer systems. This repository documents the current state of how well FreeBSD works on our systems and helps you set it up.

1. Install latest FreeBSD from installer
2. Create your user, adding it to the wheel group
3. Reboot into installed system
4. Log into root
5. Install sudo: pkg install sudo
6. Run visudo and remove # from infront of the line with wheel
7. Log out and log into your user
8. sudo pkg install git py311-ansible
9. git clone https://github.com/FrameworkComputer/freebsd-on-framework
10. cd freebsd-on-framework
11. Run sudo ls and type your password to unlock passwordless sudo
12. Run your desired Playbook, e.g. ansible-playbook kde-xorg.yml

• kde-xorg.yml KDE on Xorg

TODO: KDE on Wayland

• UEFI Framebuffer (SCFB)
• Intel GPU driver (11th-13th Gen)
  • Working with drm-61-kmod on 12th Gen
• Intel GPU driver (Intel Core Ultra)
  • Needs at least 6.6, not in FreeBSD yet, see below for details
• Intel AX210 WiFi
  • Only 802.22g support in FreeBSD, up to 54Mbit
• Intel AX210 Bluetooth
  • Not supported in FreeBSD kernel yet, see below
• Fingerprint Reader
  • Working. Fixes are being upstreamed. See here
• Ambient Light Sensor (I2C HID)
  • Work-in-progress by Framework
• Built-in Camera
• Built-in Microphone
• Suspend (S3) on 11th-13th Gen
  • Works with Intel GPU driver, not with SCFB
  • Wakes up only on power button, or lid, not keyboard press
• Suspend (S0ix) on Intel Core Ultra
  • Not supported yet by FreeBSD, see below
• Expansion Cards
  • USB-C
  • USB-A
  • MicroSD
  • SD
  • SSD
  • Audio
  • Ethernet
    • Currently with cdce driver, soon better support with ure driver
  • HDMI
    • Works with Intel GPU driver, does not work with SCFB
  • DisplayPort
    • Works with Intel GPU driver, does not work with SCFB
• Intel P-State power measurements
  • Work-in-progress by Framework

The graphics driver in FreeBSD 14.1 does not work on this Intel CPU generation. At least DRM 6.6 is needed, which can be built with FreeBSD 15-CURRENT and drm-kmod PR #283.

Please refer to Hardware Interaction for details. The commands there are especially useful for Linux users coming to FreeBSD.

• WiFi Driver (iwlwifi) sometimes crashes on shutdown or resume from S3)
  • Workaround
• iwlwifi limited to 802.11g speed
  • Workaround by using a Linux virtual machine
• AX210 Bluetooth not supported yet
  • https://reviews.freebsd.org/D44861
• RZ616 not supported yet
  • https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=264300
• S0ix and s2idle not supported yet
  • https://reviews.freebsd.org/D17675
  • https://reviews.freebsd.org/D17676