Ultramarine Dashboard

Dashboard for Ultramarine Server management. This app is intended to run self-hosted on an Ultramarine Server host.

Usage (dev)

1. pnpm install
2. Start the development services from dev/ if you need a local database or network services.
3. Create apps/dashboard/.env with the required values below.
4. Set up the database: pnpm --filter ultramarine-dashboard-app db:migrate
5. Seed test IPs if needed: podman exec -i fyra-postgres psql -U postgres < dev/seed-ipam.sql
6. pnpm --filter ultramarine-dashboard-app dev

Details, one-time machine setup, and caveats: dev/README.md

For UI-only work on macOS or without the local database/backend stack, use the fixture mode documented in dev/README.md.

Build and run

pnpm --filter ultramarine-dashboard-app build
ORIGIN=http://localhost:3000 \
BETTER_AUTH_SECRET=replace-me \
DATABASE_URL=postgres://postgres:postgres@127.0.0.1:5432/postgres \
EMAIL_FROM_ADDRESS=no-reply@localhost \
EMAIL_FROM_NAME="Ultramarine Server" \
EMAIL_REPLY_TO=support@localhost \
node apps/dashboard/build

Environment

Required:

• ORIGIN — public dashboard origin.
• BETTER_AUTH_SECRET — Better Auth signing secret.
• DATABASE_URL — PostgreSQL connection URL.
• EMAIL_FROM_ADDRESS, EMAIL_FROM_NAME, EMAIL_REPLY_TO — email identity values.

Email verification is disabled by default. Set EMAIL_VERIFICATION_REQUIRED=true once setup includes a configured mail provider.

Optional:

• VYOS_API_URL, VYOS_API_KEY, VYOS_VERIFY_SSL
• GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET
• INTERNAL_CRON_SECRET