# Archipelago OS Image Recipes

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

## Quick Start

### On macOS

```bash
./build-macos.sh
```

### On Linux

```bash
./build-linux.sh
```

See [Building OS Images](../../docs/building-os-images.md) 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](../../docs/building-os-images.md) for Archipelago-specific builds.