logo

bootstrap-initrd

Linux initrd to bootstrap from a small binary seed git clone https://anongit.hacktivis.me/git/bootstrap-initrd.git/

README.md (2870B)

    

  1. # bootstrap-initrd
  2. ```
  3. Copyright 2017 Haelwenn (lanodan) Monnier <contact@hacktivis.me>
  4. SPDX-License-Identifier: MPL-2.0
  5. ```
  7. A initrd generator for Linux to bootstrap a POSIX-ish system from a reasonably small binary seed.
  9. ## Status
  10. - [x] Small binary seed of only TCC and musl (~1.2MB of binaries, depending on the architecture), enforced by [deblob](https://hacktivis.me/projects/deblob)
  11. - [x] Capable of bootstrapping <https://git.sr.ht/~mcf/oasis>
  12. - [ ] Self-replicating: Able to reassemble the initrd with Alpine apks
  13. - [ ] Self-hosting: Able to recompile all the software used from source (including tcc and musl)
  14. - [x] Code compiled by `init.sh` is reviewable, mostly thanks to a lack of autotools
  16. ## Downloading
  18. Can either be downloading this git repo, or downloading from the archives at <https://distfiles.hacktivis.me/releases/bootstrap-initrd/>  
  19. The signify public keys are at <https://distfiles.hacktivis.me/releases/signify/>
  21. (Note: https is optional, the assets are signed anyway)
  23. ## Explorations
  24. - Reduce the binary seed even further, without compromising on keeping the bootstrapping simple and reasonably fast
  26. ## Non-Goals
  27. - GNU Environment, there is already <https://github.com/fosslinux/live-bootstrap> for this and it's a massive effort
  28. - Become a distro, at worst it should end up deferring to an existing ports system like <https://www.pkgsrc.org/>
  30. ## Architectures
  32. You can set `ALPINE_ARCH` to change the architecture, by default it's set to `x86_64`.
  34. - `aarch64`: Works except for extras (tested on HoneyComb LX2k with linux 6.12.21-gentoo)
  35. - `armhf`: Untested
  36. - `armv7`: Untested
  37. - `riscv64`: Works except for extras (tested on VisionFive2 with linux-lts from Alpine)
  38. - `x86`: Works
  39. - `x86_64` (aka amd64): Works
  41. ## Rationales
  43. Moved to RATIONALES.md and RATIONALES-Exclusion.md
  45. ## Extras
  47. The `/extras` directory is for software which is either specific
  48. to bootstrapping a particular system, or software which contains
  49. pregenerated code rather than 100% source code.
  51. You can automatically build all of it with `/extras-build-all.sh`
  53. You can exclude those tarballs from the initrd with setting
  54. the `EXCLUDE_EXTRAS` environment variable to any value.
  56. ## Launching in QEMU
  57. * You need a Linux kernel, so far no known version limitations
  58. * Combination of `panic=1` and `-no-reboot` allows to exit+relaunch
  60. ```
  61. $ ./make-initrd.sh && qemu-system-x86_64 -enable-kvm -m 512 -kernel /boot/vmlinuz-6.6.21-gentoo -initrd bootstrap-initrd/x86_64+extras.cpio.gz -append 'init=/init console=ttyS0 panic=1' -nographic -no-reboot
  62. ```
  64. ## Dev setup via bubblewrap
  66. ```
  67. $ ./make-root.sh && bwrap --clearenv --unshare-all --bind bootstrap-initrd/x86_64+extras/ / --proc /proc --dev /dev --uid 0 --gid 0 /init
  68. ```
  70. Useful as it allows to manipulate the environment externally, for example to edit files in an editor more comfortable than `ed(1)`.