VATSIM Monitor Quick Start

Start the monitoring stack.

Docker Compose starts MariaDB, the API server, and the web UI.

Docker install

git clone https://github.com/kriziw/VATSIM-Monitor.git
cd VATSIM-Monitor
cp .env.docker.example .env
docker compose pull
docker compose up -d

Before first real start

Edit .env before treating the install as real.

  • Change MYSQL_ROOT_PASSWORD and MYSQL_PASSWORD.
  • Optionally set TZ, WEB_PORT, SERVER_PORT, and APP_VERSION.
  • Docker creates named volumes for MariaDB data and server logs: mariadb_data and server_logs.

Domain or reverse proxy

If users will open the web UI through a domain, set the public origin and forwarded-header variables in .env.

ORIGIN=https://monitor.example.com
PROTOCOL_HEADER=x-forwarded-proto
HOST_HEADER=x-forwarded-host
PORT_HEADER=x-forwarded-port

ORIGIN must exactly match the browser URL, otherwise SvelteKit may reject login or registration form posts.

First checks

  • Web UI defaults to http://localhost:3000.
  • Backend defaults to http://localhost:8080.
  • Update database passwords in .env before treating the install as real.

After sign-in

Create watch rules, add Discord webhook channels, optionally enable top-down matching, and use the logs page for troubleshooting when enabled from Settings.