Introduction
Once you have your Framework Desktop set up following the Quick Start Guide, you’re ready to install your preferred OS. Ubuntu 26.04 works fantastically well.
Tools
No tools specified.
Parts
-
-
First, download Ubuntu 26.04 Desktop image from Ubuntu's website. We'll go through the steps in this Guide assuming you have a simple installation scenario of a fresh install on a blank drive.
-
Download balenaEtcher as a tool to create the USB installer from the ISO. balenaEtcher is available for MacOS. Install it.
-
Before booting to the Live USB drive, a note about secure boot.
-
Launch balenaEtcher. Insert your USB drive (8GB or larger). Click on "Flash from file" and select the ubuntu-26.04-desktop-amd64.iso that you downloaded. Click on "Select target" and choose your USB drive. Click "Flash" and wait a minute or two for it to complete.
-
Once the USB drive creation is complete, you can close balenaEtcher and eject the USB drive from your OS.
-
-
-
First, download Ubuntu 26.04 Desktop image from Ubuntu's website. We'll go through the steps in this Guide assuming you have a simple installation scenario of a fresh install on a blank drive.
-
Download Rufus as a tool to create the USB installer from the ISO - select the top download option from the link provided. Rufus is available for Windows. Install it.
-
If you are removing Windows to install Linux, you may run into the "Device is Active" error. This will provide you with guidance to overcome this error.
-
Before booting to the Live USB drive, a note about secure boot.
-
Launch Rufus. Insert your USB drive (8GB or larger). Click on "Flash from file" and select the ubuntu-26.04-desktop-amd64.iso that you downloaded. Click on "SELECT" and choose your USB drive. Click "START" and wait a minute or two for it to complete.
-
-
-
Secure Boot is optional: Enabling secure boot is completely optional and not necessary for normal operation, it's a personal choice - but there are trade offs to be aware of. Follow this link if you wish to enable it before installing Ubuntu. More about secure boot here.
-
If you have decided to disable secure boot. You will do so by booting into the BIOS menu:
-
Power on, then tap F2 rapidly at the Framework splash screen
-
Select Administer Secure Boot tile on the screen. Press enter.
-
Go to Enforce Secure Boot, it will show as Enabled. Click the enter key, arrow it to Disabled. Press F10 key to save and reboot.
-
IMPORTANT: If you're planning on booting with Windows at all, do not disable it.
-
Should you wish to enable it later in the future, repeat the above steps but select Enable this time.
-
-
-
Once you have reviewed the previous step, continue
-
Boot to Live Ubuntu USB: Insert the USB drive into the powered-off machine, then power it on.
-
If an OS is already installed, immediately begin tapping F12 as soon as the power light comes on. Start tapping before the Framework logo appears.
-
At the Boot Option Menu, use arrow keys to select your USB drive (shown as "Linpus lite (General UDisk)" or similar) and press Enter. On the black GRUB menu, confirm "Try or Install Ubuntu" is highlighted and press Enter.
-
Choose your language: Select English or your preferred language from the list. Click Next.
-
-
-
Language: Select your preferred language. Click next.
-
Accessibility: Adjust Seeing, Hearing, Typing, Pointing and clicking, or Zoom settings if needed. All accessibility options can be changed later in the Settings app. Click Next when done.
-
Keyboard layout: Select your keyboard layout from the list (default is English US). Choose a matching variant from the dropdown on the right. Test the layout in the "Type here to test your keyboard" field. Click Next.
-
Internet connection: Choose wired connection, Wi-Fi network, hidden Wi-Fi network, or Do not connect. An internet connection improves the install with compatibility checks and extra software packages. Click Next.
-
-
-
Try or install Ubuntu: Select "Install Ubuntu" to begin installation. Click Next.
-
Type of installation: Select "Interactive installation" for the guided step-by-step setup. Click Next.
-
Applications: Select "Default selection" for essentials plus a web browser and basic utilities. Select "Extended selection" if you want an offline-friendly set of office tools included. Click Next.
-
-
-
Optimize your computer: Check "Install third-party software for graphics and Wi-Fi hardware." Check "Download and install support for additional media formats" for MP3, MP4, MOV, and similar. Click Next.
-
Disk setup: Select "Erase disk and install Ubuntu" for a clean install. Warning: this wipes all data and partitions on the target drive. Other options: install alongside an existing OS, erase only an existing Ubuntu install, or manual partitioning. Click Next.
-
Choose the installation drive: Select the target drive from the "Select drive" dropdown, for example nvme0n1. Confirm the Ubuntu entry below shows the correct drive name and size. Click Next.
-
-
-
Encryption and file system: Select "No encryption" for an unencrypted install. Select "Encrypt with a passphrase" to require a passphrase at every boot. Select "Use hardware-backed encryption" to have the disk unlock automatically at startup. Click Next.
-
Create your account: Enter your name in the "Your name" field. Enter a hostname in the "Your computer's name" field. Enter a username in the "Your username" field.
-
Enter a password, then enter it again in the "Confirm password" field. Leave "Require my password to log in" checked unless you want auto-login. Check "Use Active Directory" only if joining an AD domain. Click Next.
-
Select your timezone: Confirm the Location field matches your city or region. Confirm the Timezone field matches your zone. Click on the map to adjust if the values are wrong. Click Next.
-
-
-
Review your choices: Verify Type of installation, Installation disk, and Applications under General. Verify Disk encryption and Proprietary software under Security & more. Verify the Partitions list. Click Install to begin.
-
Installation runs: The installer copies files and displays a slideshow while it works. When finished, you will be prompted to remove the USB and reboot.
-
-
-
Remove the USB and reboot: When the installer finishes, click "Restart now" in the dialog. When prompted with "Please remove the installation medium, then press ENTER," unplug the USB drive. Press Enter to reboot into the installed system.
-
First boot - log in: At the GDM login screen, click your username. Enter the password you set during installation. Press Enter or click Sign In.
-
Welcome to Ubuntu: The setup assistant opens with "Welcome to Ubuntu 26.04 LTS!" Click "View release notes" if you want to read what's new. Click Next to continue.
-
Location Services: Toggle "Location Services" on if you want apps to determine your geographical location. Leave it off to keep location access disabled. Click Next. This can be changed later in the Settings app.
-
Help Improve Ubuntu: Toggle "Share system data with the Ubuntu team" on or off (hardware info, language, timezone). Toggle "Share error reports with the Ubuntu team" on or off (crash reports and related system logs).
-
Appearance: Select "Default" for a light window style or "Dark" for a dark window style. Choose an accent color from the row of colored circles. Click Next. This can be changed later in the Settings app.
-
Ready to go: The final "Get started with more applications" screen appears. Click "Open App Center" to browse additional apps now, or skip it. Click Finish to close the setup assistant.
-
-
-
Click here for the completion guide for the Framework Desktop.
-
Important expansion card behavior.
-
-
-
Go to and click upper left corner where you see the horizontal line, search terminal and launch it. Please follow this link to copy and paste the code into your terminal, then press enter.
-
The output will tell you which Framework Desktop BIOS version you're using.
-
Framework Desktop firmware update link.
-
-
-
Please visit our troubleshooting guide first.
-
If you need additional help, feel free to visit our active support community.
-
Enjoy using Ubuntu on your Framework Laptop Desktop!
Enjoy using Ubuntu on your Framework Laptop Desktop!