carbonOS 2022.1 is pre-release software!
Bad things will happen if you use it in a production environment.
You've been warned
Installing carbonOS
Updated for 2022.1
These instructions are a quick guide to getting carbonOS installed and ready
for testing.
System Requirements
- EFI firmware
- CPU new enough to support x86-64-v3 (generally, CPUs made after 2016 work)
- Intel Integrated Graphics or AMD GPU. NVIDIA GPUs ARE NOT SUPPORTED BY THIS
EARLY DEVELOPMENT BUILD, BUT MAY WORK IN AN EXTREMELY LIMITED CAPACITY.
Proper NVIDIA support will be coming in the near future
Installing onto hardware
- Download the ISO Image
- Write the ISO to a USB flash drive, using
dd
, balenaEtcher, or similar software
- Boot your machine into the EFI firmware. Disable secure boot, and
ensure that your USB drive has priority in the boot order
- Boot your machine from the USB drive.
- Select “Try or Install carbonOS” from the menu. You can select the ramdisk
alternative if necessary (i.e. you want to remove the USB drive during
installation), but I don’t recommend using the ramdisk unless you have at least
8GB of RAM.
- Once the system boots, select your language and follow the on-screen
instructions
Installing onto GNOME Boxes
- Ensure that GNOME Boxes can support EFI systems. This depends on how
you installed Boxes and on your distribution. The easiest method to ensure
everything is correct is to install Boxes from Flathub
- Download the ISO Image
- Create a new virtual machine, and select the ISO image you downloaded
- Boxes will tell you that it couldn’t recognize the OS. In the list of
OS options, select “GNOME OS”. This step is absolutely essential! carbonOS
will not boot without it
- Follow the on-screen instructions to finish creating the VM
- Start the VM
- Select “Try or Install carbonOS” from the menu
- Once the system boots, select your language and follow the on-screen
instructions
Installing onto VirtualBox
For the best experience, I’d recommend testing carbonOS through
GNOME Boxes. Running carbonOS on VirtualBox is possible, but there are known
issues:
- VirtualBox tends to drop you into an EFI shell instead of properly selecting
carbonOS’s bootloader
- VirtualBox’s GPU driver has incompatabilities with hardware-accelerated
mouse cursors, so you may experience strangeness (invisible cursors, upside-down
cursors, etc)
If you want to try working around these issues, please join #carbonOS:matrix.org
and I’ll help you get it installed. Then I’ll write some proper instructions here
Dual-boot, custom partitions, etc
These setups are not officially supported by carbonOS. However, if you’d like
to use carbonOS in these scenarios anyway, you’ll need to follow the
advanced installation instructions.
Be warned, that these instructions assume you have the prerequisite knowledge
to manually manipulate Linux partitions, filesystems, and configuration.