2517379ac3
- Update all references from Debian 12 (Bookworm) to Debian 13 (Trixie) - Enable SystemCallArchitectures, RestrictAddressFamilies, RestrictRealtime in archipelago.service (safe on systemd 256+ which respects NoNewPrivileges=no) - Update GLIBC compatibility checks from 2.36 to 2.40 - ISO filename, build container, and docs updated throughout Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2.3 KiB
2.3 KiB
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-13-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
cpinstead ofscp) - Configure Podman registries on dev server for fallback source builds