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`
|
2026-02-01 02:22:02 +00:00
|
|
|
- Requires: Rust toolchain (or Docker)
|
|
|
|
|
- Builds for Linux x86_64
|
2026-01-24 22:59:20 +00:00
|
|
|
|
|
|
|
|
### `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.
|
2026-02-01 02:22:02 +00:00
|
|
|
- Checks: Rust, Node.js, Docker, xorriso
|
2026-01-24 22:59:20 +00:00
|
|
|
- Provides installation instructions
|
|
|
|
|
- Non-blocking (warns but continues)
|
|
|
|
|
|
2026-02-01 02:22:02 +00:00
|
|
|
### `install-podman.sh`
|
|
|
|
|
Installs Podman container runtime.
|
|
|
|
|
- For use inside the target system
|
|
|
|
|
- Configures rootless Podman
|
2026-01-24 22:59:20 +00:00
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
2026-02-01 02:22:02 +00:00
|
|
|
These scripts are called automatically by the main build process. You can also run them manually for testing:
|
2026-01-24 22:59:20 +00:00
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# Build just the backend
|
|
|
|
|
./scripts/build-backend.sh
|
|
|
|
|
|
|
|
|
|
# Build just the frontend
|
|
|
|
|
./scripts/build-frontend.sh
|
|
|
|
|
|
2026-02-01 02:22:02 +00:00
|
|
|
# Check dependencies
|
|
|
|
|
./scripts/check-dependencies.sh
|
2026-01-24 22:59:20 +00:00
|
|
|
```
|
