Files
archipelago 83aacdf209 chore(release): archive ISO build recipes, tarball-only releases
Releases no longer ship as bootable ISOs. Archipelago updates are
distributed as the backend binary plus a frontend tarball referenced by
releases/manifest.json. Nodes OTA-update via scripts/self-update.sh.

Filebrowser and AIUI remain bundled inside the frontend tarball and
deployed atomically, verified present in v1.7.43-alpha release artifact
(189 AIUI files, filebrowser-client bundle).

Archived under image-recipe/_archived/ (resurrectable if ISO distribution
is reintroduced):
  - build-auto-installer-iso.sh
  - build-unbundled-iso.sh
  - test-iso-qemu.sh
  - scripts/convert-iso-to-disk.sh
  - BUILD-ISO-STATUS.md, ISO-BUILD-CHECKLIST.md
  - branding/isohdpfx.bin
  - .gitea/workflows/build-iso-dev.yml

Updated release process docs to drop ISO references:
  - scripts/create-release.sh (next-steps text)
  - docs/BETA-RELEASE-CHECKLIST.md
  - docs/hotfix-process.md
  - README.md
2026-04-23 15:36:00 -04:00
..
2026-01-24 22:59:20 +00:00

Build Scripts

Helper scripts for building Archipelago OS images.

Scripts

build-backend.sh

Compiles the Archipelago Rust backend binary.

  • Output: ../build/backend/archipelago
  • Requires: Rust toolchain (or Docker)
  • Builds for Linux x86_64

build-frontend.sh

Builds the Vue.js frontend for production.

  • Output: ../build/frontend/
  • Requires: Node.js 18+, npm
  • Builds static files for serving

convert-iso-to-disk.sh

Converts ISO image to raw disk image.

  • Input: ISO file
  • Output: .img file ready for dd
  • Creates partition layout (EFI + root)

check-dependencies.sh

Checks if all build dependencies are available.

  • Checks: Rust, Node.js, Docker, xorriso
  • Provides installation instructions
  • Non-blocking (warns but continues)

install-podman.sh

Installs Podman container runtime.

  • For use inside the target system
  • Configures rootless Podman

Usage

These scripts are called automatically by the main build process. You can also run them manually for testing:

# Build just the backend
./scripts/build-backend.sh

# Build just the frontend
./scripts/build-frontend.sh

# Check dependencies
./scripts/check-dependencies.sh