kupferbootstrap
Kupfer Linux bootstrapping tool - drives pacstrap, makepkg, chroot, mkfs and fastboot, just to name a few.
Documentation
Detailed docs for the main branch are available online at https://kupfer.gitlab.io/kupferbootstrap/
You can also build and view the docs locally:
cd docs/ && \
make && \
make serve
This will run a webserver on localhost:9999. Access it like firefox http://localhost:9999/
Installation
- If you're not on ArchLinux (i.e. don't have
pacman,makepkg, etc. available in your $PATH), install Docker and add yourself to the docker group. - Craate a python venv:
python3 -m venv venv - Activate it:
source venv/bin/activate - Install KBS:
pip3 install .
Then run kupferbootstrap.
Pro Tip:
- You can add a shell alias for
$(PWD)/venv/bin/kupferbootstrapor create a symlink to it at/usr/local/bin/kuperbootstrapfor quick access without needing to manually source the venv script every time. - It is recommended to abbreviate
kupferbootstraptokbsfor even less typing.
Quickstart
- Initialize config with defaults, configure your device and flavour:
kupferbootstrap config init - Initialize PKGBUILDs and caches:
kupferbootstrap packages init - Build an image and packages along the way:
kupferbootstrap image build
Development
Docker
Put BUILD (the default) into docker_version.txt to always rebuild kupferboostrap from this directory; otherwise the image is pulled from registry.gitlab.com/kupfer/kupferbootstrap:$VERSION, where $VERSION is the contents of docker_version.txt.