carbonOS 2022.3 is pre-release software!
Bad things will happen if you use it in a production environment.
You've been warned
Updated for 2022.3
These instructions are a quick guide to getting carbonOS installed and ready
CPU new enough to support x86-64-v3 (generally, CPUs made after 2016 work)
Intel or AMD graphics
NVIDIA support is still unfinished!
There are still a couple of known issues and rough edges around NVIDIA GPUs.
The pieces are all there, but it just doesn't work yet.
Installing onto hardware
I've been made aware of an issue that makes it impossible for carbonOS to be
installed from the 2022.3 ISO. There is a workaround, which I've described
here (step 6 and onward). Please make sure to follow these steps carefully!
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”
Follow the on-screen instructions to finish creating the VM
Start the VM
Select “Try or Install carbonOS” from the menu
Follow steps 6-13 of the “Installing onto Hardware” section
Installing onto VirtualBox
For the best experience & compatibility, I’d recommend testing carbonOS through
GNOME Boxes. Running carbonOS on VirtualBox is possible, but there are known
VirtualBox tends to drop you into an EFI shell instead of properly selecting
VirtualBox’s GPU driver may have visual oddities, such as invisible or
If you want to try working around these issues, please join
#carbonOS on Matrix 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.