Website • Discord • Releases • Donate • Documentation

Buildroot

• Buildroot is a simple, efficient and easy-to-use tool to generate embedded Linux systems through cross-compilation.
• This tool compiles dahliaOS Linux-based builds.

This project is a fork from AdvancedClimateSystems/docker-buildroot.

Install Docker

• We use Docker so that we don't have to install all sorts of packages, everything is already included in this Docker image.

• You can find Docker installation instructions here.

Usage

1. Get the Docker image

docker pull ghcr.io/dahliaos/buildroot:latest

2. Setup Buildroot's volumes

docker run -i --name buildroot_output ghcr.io/dahliaos/buildroot /bin/echo "Data only."

3. Clone the buildroot repo.

git clone https://github.com/dahliaOS/buildroot.git && cd buildroot

This container has 2 volumes at /root/buildroot/dl and /buildroot_output. Buildroot downloads all data to the first volume, the last volume contains the build cache, the cross compiler and the build results.

3. Run:

The build script is used to connect to the docker container and to pass commands to it.

• sudo ./build make menuconfig to configure the build settings
• sudo ./build make linux-menuconfig to configure the Linux kernel
• sudo ./build make to compile the image, which can be found on the host machine in /images

Build and reload

To compile and run the base dahliaOS toolchain, use:

sudo ./build make&&qemu-system-x86_64 --enable-kvm -m 4096 -cdrom images/rootfs.iso9660&&cp images/rootfs.iso9660 images/rootfs.iso

Requirements

It is recommended to have at miniumum an Ethernet connection (directly to thr router), a dual-core x86 CPU and at least 4GB of RAM when compiling.

We personally recommend a 4C/8T or better CPU with 16GB of RAM for optimal speeds.

You will also need a decent amount of hard drive space, we recommend around 50GB if you clear out the build directory often.

It takes around 6 hours to build a full image from scratch on a Dell Optiplex 790 with a 3GHZ i5-2400 and 16GB of RAM.

We are sure a Threadripper or a newer Xeon CPU could easily handle compiling.

Warning:

• If you are using a laptop, make sure that you are aware of its temperature, some laptops easily heat up to 93-100c when compiling.

To do

• Add flatpak

• Add the Surface touchscreen patches to the kernel via Buildroot: https://github.com/linux-surface/linux-surface

• Add the Nvidia driver in the Buildroot config

Contribute

If you're wondering how to contribute to the project, please refer to CONTRIBUTING.md

License

Copyright @ 2019-2023 - The dahliaOS Authors - contact@dahliaos.io

Copyright @ 2017 - Auke Willem Oosterhoff and Advanced Climate Systems.

This project is licensed under the Mozilla Public License