A web dashboard for Saltbox server management. Monitor Docker containers, system health, storage mounts, Traefik routes, and installed apps from a single interface.

• Dashboard — CPU, memory, disk, network stats with service health checks
• Apps — Browse installed Saltbox apps, view details, search the install catalog
• Docker — Container list with status, actions (start/stop/restart), and live log viewer
• Storage — Mount tree, disk usage, rclone remote status, MergerFS configuration
• System — Detailed metrics, backup status, Traefik routes, service health

• SvelteKit + Svelte 5 + TypeScript
• Tailwind CSS v4
• Lucide icons
• adapter-node for server deployment
• Dockerode for Docker API access

• Node 22+ (a .node-version file is included for fnm)
• Bun package manager

bun install
bun run dev

bun run build
node build/index.js

The recommended way to run Saltbox UI on your Saltbox server.

Pre-built images are published to the GitHub Container Registry (GHCR):

# Set your domain (and optionally the channel — defaults to 'latest')
echo "DOMAIN=yourdomain.com" > .env

# Pull and start the latest stable image
docker compose up -d

# Or use the dev image:
# echo "CHANNEL=dev" >> .env && docker compose up -d

The container needs read-only access to host resources:

The docker-compose.yml includes standard Saltbox Traefik labels. The UI will be available at https://saltbox-ui.yourdomain.com with Authelia authentication.

src/
├── lib/
│   ├── components/     # Svelte components by domain
│   ├── data/           # API layer + mock data
│   ├── server/         # Server-only modules (Docker, system, storage, Traefik)
│   ├── stores/         # Svelte 5 rune stores
│   ├── types/          # TypeScript type definitions
│   └── utils/          # Formatting helpers, constants
├── routes/
│   ├── +page.svelte        # Dashboard
│   ├── apps/               # App management
│   ├── docker/             # Container management
│   ├── storage/            # Storage overview
│   └── system/             # System metrics

MIT