Dev Box Setup Scripts

A collection of scripts to set up development environments with a simple runner interface.

The installer uses current upstream channels at install time: stable Rust and Flutter, the latest Node.js release, and current package-manager releases. Supported Linux distributions include Debian/Ubuntu, Alpine, Red Hat-family systems, and Arch Linux.

Usage

Interactive Mode

Run all scripts in interactive mode:

make install

Run Specific Scripts

Run a specific script (e.g., to install nodejs):

make install-nodejs

List Available Scripts

List all available scripts:

make list-scripts

Additional Commands

make install-deps  # Install system dependencies
make build        # Build the runner
make run-scripts  # Run specified scripts (use SCRIPTS variable)
make clean        # Clean build artifacts
make deps         # Update dependencies
make test         # Run tests
make fmt         # Format code
make fmt-check   # Check code formatting
make lint        # Run linter

Arch Linux and yay

Arch bootstrap uses a full pacman -Syu upgrade and installs the standard development prerequisites. To also install the optional AUR helper yay, run the installer as a normal (non-root) user with explicit opt-in:

INSTALL_YAY=1 bash ./install.sh

Local Docker validation

Validate the installer against current Ubuntu, Debian, Alpine, and Arch Linux images with the repository's full Docker matrix:

make test-install-docker
docker compose -f .devcontainer/rust-compose.yml config

The Compose command validates the development container configuration; the Make target runs the installer and release-runner build in each current image.

Project Structure

• scripts/: Contains setup scripts
• runner/: Contains the Rust runner application
• proxmox/: Proxmox scripts and setup guides