vincentserpoul / funicular

create apk overlays for alpine linux

Funicular

Automate alpine deployment on SBCs (rpi0, rpi2, rpi3, rpi4...).

1. Configure and build on your powerful desktop
2. Save an immutable local backup (apkovl.tar.gz)
3. Burn your sdcard and run in memory on your SBC

Requirements

• Linux (only linux is supported for now)
• Docker: funicular runs a container buildt by another project, alpine-diskless-headless

Provisioners

We used a narrow concept of packer provisioners, by only allowing a shell-local configuration in order to simplify the configurations. Check the test or example folder to check some examples of provisioners.

Usage

Download the linux executable from the latest release

Here

Generate a default config

./funicular config gen

Build and burn the out example

./funicular build -t ./out/example/target -c ./out/example/config.toml -H rpi -d /dev/sda -f true

It will build the example and burn it on /dev/sda for a rpi. Next step: insert the card in a rpi and enjoy!

Todo

[ ] add a lot more docs
[ ] switch from latest-stable to v3.12
[ ] publish on crates.io as a binary (see ripgrep as an example)