lfg2025/archy

Dorian 337ebee510 Revise BUILD-GUIDE and enhance ISO build process

- Updated BUILD-GUIDE.md to streamline instructions for building the Archipelago Auto-Installer ISO, including prerequisites and post-installation steps.
- Added detailed sections on capturing the live server state and building from source.
- Enhanced Docker and Podman integration in build scripts for improved backend and web UI capture.
- Introduced new app metadata for "IndeedHub" in the Docker package scanner and updated UI components for better installation progress tracking.
- Improved styling and functionality in the Bitcoin UI for a more cohesive user experience.

2026-02-03 21:43:33 +00:00

2.3 KiB

Raw Blame History

Archipelago ISO Build - Quick Guide

TL;DR - Build ISO with Live Server State

cd ~/archy/image-recipe
sudo bash build-auto-installer-iso.sh

The script will automatically:

Try to capture backend from /usr/local/bin/archipelago
Try to capture frontend from /opt/archipelago/web-ui
Fall back to building from source if capture fails

Build Modes

Default: Capture from Dev Server (RECOMMENDED)

# From your Mac (captures from remote dev server):
cd image-recipe
DEV_SERVER=archipelago@192.168.1.228 sudo bash build-auto-installer-iso.sh

# From the dev server itself:
cd ~/archy/image-recipe
sudo bash build-auto-installer-iso.sh

Alternative: Build from Source

BUILD_FROM_SOURCE=1 sudo bash build-auto-installer-iso.sh

Known Issues & Workarounds

Issue: Can't capture from localhost via SCP

Problem: When running on the server itself, scp localhost:/path doesn't work.

Workaround: Use direct file copy instead:

# Instead of building on the server, build from your Mac:
cd ~/Projects/archy/image-recipe
DEV_SERVER=archipelago@192.168.1.228 sudo bash build-auto-installer-iso.sh

Issue: Podman registry not configured

Problem: Podman can't pull images because /etc/containers/registries.conf has no unqualified-search registries.

Fix:

ssh archipelago@192.168.1.228
sudo tee -a /etc/containers/registries.conf <<EOF
[registries.search]
registries = ['docker.io']
EOF

Flash ISO to USB

cd ~/Projects/archy/image-recipe
./write-usb-dd.sh /dev/diskX

What Gets Captured

From your dev server (192.168.1.228):

✅ Backend binary: /usr/local/bin/archipelago (6.2M)
✅ Frontend: /opt/archipelago/web-ui (~64M)
✅ Nginx config: /etc/nginx/sites-available/default
✅ Systemd service: /etc/systemd/system/archipelago.service
✅ App manifests: ~/archy/apps/

Current Status

Latest Working ISO: archipelago-debian-12-x86_64.iso (469M, built 18:28)

This ISO was built earlier today
Contains the auto-installer
Should be tested - might already have your live server state

Next Steps

Flash the existing ISO and test it on the Dell OptiPlex
Fix the build script to properly capture from localhost (use cp instead of scp)
Configure Podman registries on dev server for fallback source builds

2.3 KiB Raw Blame History