Self-hosted BIP-329 label management for Bitcoin wallets, packaged for StartOS 0.4.0.
Ported from the Umbrel packaging (2.3.0-4rkad.12) — same patched Django image, MySQL 8 + nginx sibling containers, per-instance crypto salt preserved across updates.
Download the latest .s9pk from Releases:
labelbase_x86_64.s9pk— Intel/AMD mini-PCslabelbase_aarch64.s9pk— Raspberry Pi / Start9 Server
In StartOS: Settings → Sideload Service → Upload, select the .s9pk, wait for install to finish, then Start the service.
Three sibling SubContainers inside the labelbase package, communicating over loopback (127.0.0.1):
- mysql (
mysql:8.0.36) — data dir on subpathmysqlof themainvolume. - django (
ghcr.io/4rkad/labelbase-django:2.3.0-4rkad.12) — gunicorn on:8000, mountsconfig.ini,labelbase.log,static/,media/. Depends onmysql. - nginx (
nginx:1.27-alpine) — serves static/media + reverse-proxies Django, exposes:8080to StartOS. Depends ondjango.
Secrets (secret_key, crypto_salt, MYSQL_PASSWORD, MYSQL_ROOT_PASSWORD) are generated once on first run and persisted in config.ini on the main volume — they survive updates.
Backups use sdk.Backups.withMysqlDump(...).addVolume('main') — logical DB dump plus the full main volume (config.ini, static/, media/, logs).
Requires:
- Node.js + pnpm 9+ (
npm install -g pnpm) start-cli 0.4.0-beta.5inPATH(pre-built binary, no Rust compile needed)tar2sqfs(sudo apt install squashfs-tools-ngon Debian/Ubuntu)- Developer signing key at
~/.startos/developer.key.pem(start-cli init-keyto generate)
Then:
pnpm install --frozen-lockfile
make x86 # produces labelbase_x86_64.s9pk
make arm # produces labelbase_aarch64.s9pk
make clean # remove .s9pk, ./javascript, ./node_modulesAGPL-3.0 — same as upstream Labelbase.