https://github.com/elementary/os

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

debian hacktoberfest iso linux live-build

Last synced: about 1 month ago
JSON representation

The OS build system

• Host: GitHub
• URL: https://github.com/elementary/os
• Owner: elementary
• License: gpl-3.0
• Created: 2017-06-26T20:46:37.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2025-12-05T23:35:53.000Z (about 2 months ago)
• Last Synced: 2025-12-09T13:31:03.816Z (about 2 months ago)
• Topics: debian, hacktoberfest, iso, linux, live-build
• Language: Shell
• Homepage: https://elementary.io
• Size: 506 KB
• Stars: 1,113
• Watchers: 70
• Forks: 135
• Open Issues: 23
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• stars - os

README

          


  

    


  

  

  

    

  

  


  
elementary OS

  
Build scripts for image creation

  


  






  

  



---

## 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 example assumes 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.

Configure the channel (stable, daily) in the configuration file (`etc/terraform-amd64.conf` or `etc/terraform-arm64.conf` based on your host architecture), then run:

```sh

docker run --rm --privileged -it \

    -v /proc:/proc \

    -v ${PWD}:/working_dir \

    -w /working_dir \

    debian:latest \

    ./build.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).