Build docs

Last updated July 14^th, 2026

We're really happy to announce that the build documentation for EnergyOS have been released! So... if you would like to fork EnergyOS and create something of your own, follow this guide.

Disclaimer: You will have to provide credit to BlissOS for parts of the operating system as EnergyOS in itself is a fork of BlissOS (voyager-x86 to be exact). This guide follows the exact or similar steps that we took to build EnergyOS. If you know a better way you are more than welcome to do it that way, but we can't help with any errors that you may encounter while building EnergyOS if you take that path.

These instructions are made for CachyOS, which we have chosen as the best build environment for EnergyOS, but you can change commands for your preferred distro.

Setting up the build environment

You will need some sort of Linux computer (CachyOS is the best for this) that has at least 16 gigabytes of (preferably DDR4) RAM, 512GB free storage at the bare minimum, a fairly capable processor (EnergyOS was compiled on an Intel Core i3-10110U) and a hell of a lot of patience (unless you have a very, very beefy computer).

Start by running these commands to set up all the required tools to build EnergyOS. We also reccomend that you utilize the assistance of a LLM (for example Claude) to help diagnose errors.

bash

sudo pacman -Syu

sudo pacman -S base-devel git unzip zip bc \
  clang cmake python python-pip ninja \
  jdk-openjdk ccache wget rsync

git config --global user.name "Your Name"
git config --global user.email "youremail@example.com"

Replace "Your Name" and "youremail@example.com" with your credentials.

Then, sync the platform manifest by running these commands (replace j value with your thread count):

bash

repo init -u https://github.com/EnergyOSDevs/plat_manifest-15 -b voyager-x86

repo sync -c -j4

source build/envsetup.sh

lunch

(to be continued)