Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/elementary/os

The OS build system
https://github.com/elementary/os

debian hacktoberfest iso linux live-build

Last synced: 7 days ago
JSON representation

The OS build system

Awesome Lists containing this project

README

        





elementary





elementary OS


Build scripts for image creation







Stable
Daily 8.0
Daily ARM

---

## Building Locally

As elementary OS is built with the Debian version of `live-build`, not the Ubuntu patched version, it's easiest to build an elementary .iso in a Debian VM or container. This prevents messing up your host system too.

The following examples assume you have Docker correctly installed and set up, and that your current working directory is this repo. When done, your image will be in the `builds` folder.

### 64-bit AMD/Intel

Configure the channel in the `etc/terraform.conf` (stable, daily), then run:

```sh
docker run --rm --privileged -it \
-v /proc:/proc \
-v ${PWD}:/working_dir \
-w /working_dir \
debian:latest \
./build.sh etc/terraform.conf
```

### Raspberry Pi 4

```sh
docker run --rm --privileged -it \
-v /proc:/proc \
-v ${PWD}:/working_dir \
-w /working_dir \
ubuntu:24.04 \
./build-rpi.sh
```

### Pinebook Pro

```sh
docker run --rm --privileged -it \
-v /proc:/proc \
-v ${PWD}:/working_dir \
-w /working_dir \
ubuntu:24.04 \
./build-pinebookpro.sh
```

## Further Information

More information about the concepts behind `live-build` and the technical decisions made to arrive at this set of tools to build an .iso can be found [on the wiki](https://github.com/elementary/os/wiki/Building-iso-Images).