Use of a Linux initramfs to fully automate the bootstrapping process
Go to file
Andrius Štikonas c8784cbcd3 Split installed files out of /after into /image. 2021-06-29 17:49:34 +01:00
.reuse Recheck all of the fletcher16 using sha-2 2021-02-20 10:52:54 +11:00
LICENSES Update to stage0-posix 1.3. 2021-06-16 21:24:48 +01:00
lib Do not require chroot to be in PATH of non-root user. 2021-04-22 21:55:52 +01:00
sysa Split installed files out of /after into /image. 2021-06-29 17:49:34 +01:00
.cirrus.expect Port to Python 2021-04-11 00:06:24 +01:00
.cirrus.yml Remove 2021-04-11 00:06:24 +01:00
.gitignore Port to Python 2021-04-11 00:06:24 +01:00
.gitmodules Use the new repository URL for stage0-posix. 2021-06-22 21:18:42 +01:00 Remove 2021-04-11 00:06:24 +01:00
README.rst Remove 2021-04-11 00:06:24 +01:00
SHA256SUMS.sources Switch to compressed gzip tarball. 2021-06-21 23:04:52 +01:00
parts.rst Split installed files out of /after into /image. 2021-06-29 17:49:34 +01:00 Add config file and force timestamp conditional option 2021-05-20 02:04:39 +03:00 Switch to compressed gzip tarball. 2021-06-21 23:04:52 +01:00


<html xmlns="" xml:lang="en" lang="en"> <head> </head>


An attempt to provide a reproducible, automatic, complete end-to-end bootstrap from a minimal number of binary seeds to a supported fully functioning operating system.

Get me started!

  1. git clone
  2. git submodule update --init --recursive
  3. Provide a kernel (vmlinuz file) as the name kernel in the root of the repository.
  4. ./ - ensure your account has kvm privileges and qemu installed.
    1. Alternatively, run ./ --chroot to run it in a chroot.
    2. Alternatively, run ./ but dont run the actual virtualization and instead copy sysa/tmp/initramfs to a USB or some other device and boot from bare metal.
  5. Wait.
  6. If you can, observe the many binaries in /after/bin! When the bootstrap is completed bash is launched providing a shell to explore the system.


This project is a part of the bootstrappable project, a project that aims to be able to build complete computing platforms through the use of source code. When you build a compiler like GCC, you need another C compiler to compile the compiler - turtles all the way down. Even the first GCC compiler was written in C. There has to be a way to break the chain…

There has been significant work on this over the last 5 years, from Jeremiah Orians stage0, hex2 and M2-Planet to jannekes Mes. We have a currently, fully-functioning chain of bootstrapping from the 357-byte hex0 seed to a complete GCC compiler and hence a full Linux operating system. From there, it is trivial to move to other UNIXes. However, there is only currently one vector through which this can be automatically done, GNU Guix.

While the primary author of this project does not believe Guix is a bad project, the great reliance on Guile, the complexity of many of the scripts and the rather steep learning curve to install and run Guix make it a very non plug-and-play solution. Furthermore, there is currently (Jan 2021) no possible way to run the bootstrap from outside of a pre-existing Linux environment. Additionally, Guix uses many scripts and distributed files that cannot be considered source code.

(NOTE: Guix is working on a Full Source Bootstrap, but Im not completely sure what that entails).

Furthermore, having an alternative bootstrap automation tool allows people to have greater trust in the bootstrap procedure.

Comparison between GNU Guix and live-bootstrap

Item Guix live-bootstrap
Total size of seeds [1] ~30MB (Reduced Source Bootstrap) [2] ~1KB
Use of kernel Linux-Libre Kernel Any Linux Kernel (2.6+) [3]
Implementation complete Yes No (in development)
Automation Almost fully automatic Optional user customization

[1]: Both projects only use software licensed under a FSF-approved free software license. [2]: Reiterating that Guix is working on a full source bootstrap, although that still uses guile (~12 MB). [3]: Work is ongoing to use other, smaller POSIX kernels.

Why would I want bootstrapping?

That is outside of the scope of this README. Heres a few things you can look at:

Specific things to be bootstrapped

GNU Guix is currently the furthest along project to automate bootstrapping. However, there are a number of non-auditable files used in many of their packages. Here is a list of file types that we deem unsuitable for bootstrapping.

  1. Binaries (apart from seed hex0, kaem, kernel).
  2. Any pre-generated configure scripts, or Makefile.ins from autotools.
  3. Pre-generated bison/flex parsers (identifiable through a .y file).
  4. Any source code/binaries downloaded within a softwares build system that is outside of our control to verify before use in the build system.
  5. Any non-free software. (Must be FSF-approved license).

How does this work?

For a more in-depth discussion, see parts.rst.


sysa is the first system used in live-bootstrap. We move to a new system after a reboot, which often occurs after the movement to a new kernel. It is run by the seed Linux kernel provided by the user. It currently compiles everything.