Potentially out-of-date!
This support article was written an older version of carbonOS, so the
information it contains might no longer apply to the latest version.
Continue at your own risk!
Manually Installing carbonOS
Updated for 2022.1
Manually installing carbonOS from the command line gives you complete control
over the parition layout of the system, and other install-time settings.
This is useful, for instance, if you’d like to dual-boot
carbonOS with another system, or if you’d like to use a different filesystem
type. Please keep in mind, however, that only the default partition layout
created by carbonOS’s basic installer is officially supported.
- 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, follow the on-screen instructions until it asks you
whether you want to try or install the OS. Select “Try”
- In the LiveOS session, bring up a terminal. You’ll need to use
pkexec
to
give yourself root privilages
- Create & format your partitions/filesystems however you wish. carbonOS 2022.1
requires that the partition label of the root partition is
carbon-root
. This
will change in future versions of the OS.
- Mount the partitions. I suggest doing this in
/mnt
- Run
updatectl init-os --sysroot=/path/to/mounted/sysroot /sysroot
. This
will copy carbonOS’s system files into your partition layout.
- Unless your partitions follow the
Discoverable Partitions Spec,
you’ll need to create an
/etc/fstab
file. Once you create and appropriately
populate this file, you’ll need to copy it into
/path/to/mounted/sysroot/ostree/deploy/carbonOS/deploy/*/etc/
, which will
become /etc
once you boot into your new installation of carbonOS
- Install the bootloader by running
bootctl install
. If you’d like to use
a custom bootloader, it will need to be compatible with the
Boot Loader Spec
- Reboot. carbonOS should now be installed