archy/image-recipe/README.md
2026-01-24 22:59:20 +00:00

1.2 KiB

Archipelago OS Image Recipes

Build scripts and profiles for creating bootable Alpine Linux OS images for Archipelago Bitcoin Node OS.

Quick Start

On macOS

./build-macos.sh

On Linux

./build-linux.sh

See Building OS Images for detailed instructions.

What's Included

  • Alpine Linux Base: Minimal, secure Linux distribution
  • Podman: Container runtime for apps
  • Archipelago Backend: Rust-based API server
  • Archipelago Frontend: Vue.js web interface
  • Systemd Services: Automatic service management
  • Network Configuration: Ready for network setup

Build Output

  • archipelago-{version}-x86_64.iso - Bootable ISO image
  • archipelago-{version}-x86_64.img - Disk image for flashing

Supported Platforms

  • x86_64: Dell Optiplex, HP ProDesk 400 G4 DM, and other x86_64 desktops
  • Build Systems: macOS (via Docker) and Linux (native or Docker)

Legacy StartOS Build

The original StartOS build scripts are still available:

  • build.sh - StartOS Debian-based image builder
  • run-local-build.sh - StartOS build helper

See Building OS Images for Archipelago-specific builds.