Rust WebRCON

Monorepo for Rust server WebRCON management:

• apps/web: Next.js 16 (React 19) + shadcn (Base UI)
• apps/gateway: Rust axum gateway for RCON sessions + log streaming

Prerequisites

• Bun (bun --version)
• Rust toolchain (cargo --version)

First-time setup

# from repo root
bun install

cp apps/web/.env.example apps/web/.env
cp apps/gateway/.env.example apps/gateway/.env

# keep these two values aligned across files:
# - GATEWAY_INTERNAL_TOKEN
# - GATEWAY_PUBLIC_WS_URL (web) / GATEWAY_PUBLIC_WS_BASE (gateway)

bun --cwd apps/web run db:generate
bun --cwd apps/web run db:migrate
bun --cwd apps/web run db:seed

Run both servers (one command)

# parallel startup (default)
bun run dev

# sequential startup (gateway healthy first, then web)
bun run dev:seq

Endpoints:

• Web: http://localhost:3000
• Gateway health: http://localhost:4000/health

Useful scripts

bun run dev:web       # only Next.js app
bun run dev:gateway   # only Rust gateway
bun run build         # web build + gateway release build
bun run check         # web lint + gateway cargo check

Public repo checklist

• Keep real secrets only in local .env files (already gitignored)
• Commit .env.example files only
• Commit apps/web/bun.lock for reproducible Bun installs
• Run bun run check before pushing

Rust RCON WebSocket format

This project follows Facepunch WebRCON convention:

ws(s)://<host>:<port>/<rcon_password>