# Habland Environment Variables

Reference for `.env` values used by Docker Compose and the admin panel. Copy `.env.example` to `.env` and adjust as needed before running `docker compose up -d` or `./docker-manage.sh`.

## Core Database
- `MYSQL_ROOT_PASSWORD` – root password for `unified-db` (MariaDB).
- `DB_HOST` / `DB_PORT` – host and port used by services to reach MariaDB (defaults: `unified-db`, `3306`).

## Retro (Arcturus)
- `RETRO_API_URL` – base URL the clients use to reach the Arcturus API (default `http://localhost`).
- `RETRO_WS_URL` – websocket URL for the Arcturus emulator (default `ws://localhost:30000`).

## AtomCMS
- `ATOMCMS_APP_NAME` – display name.
- `ATOMCMS_ENV` – runtime environment (`production` by default).
- `ATOMCMS_KEY` – Laravel app key (generate if blank).
- `ATOMCMS_DEBUG` – enable verbose debug output (`true`/`false`).
- `ATOMCMS_URL` – public URL for the CMS.
- `ATOMCMS_DB` / `ATOMCMS_DB_USER` / `ATOMCMS_DB_PASS` – database name and credentials (defaults map to MariaDB root).

## Emulator Databases
- `HAVANA_MYSQL_USERNAME` / `HAVANA_MYSQL_PASSWORD` / `HAVANA_MYSQL_DATABASE`
- `KEPLER_MYSQL_USERNAME` / `KEPLER_MYSQL_PASSWORD` / `KEPLER_MYSQL_DATABASE`
- `ROSEAU_MYSQL_USERNAME` / `ROSEAU_MYSQL_PASSWORD` / `ROSEAU_MYSQL_DATABASE`

## Ports (host mappings)
- `DB_PORT`, `REDIS_PORT`, `PHPMYADMIN_PORT`
- `ARCTURUS_GAME_PORT`, `ARCTURUS_RCON_PORT`
- `HAVANA_GAME_PORT`, `HAVANA_MUS_PORT`, `HAVANA_RCON_PORT`
- `KEPLER_GAME_PORT`, `KEPLER_MUS_PORT`
- `ROSEAU_GAME_PORT`, `ROSEAU_RCON_PORT`
- `COOL_UI_PORT`, `NITRO_REACT_PORT`, `HAVANA_WEB_PORT`, `ROSEAU_CLIENT_PORT`
- `ASSET_SERVER_PORT`, `ATOMCMS_HTTP_PORT`, `ATOMCMS_HTTPS_PORT`, `ADMIN_PANEL_PORT`

## Admin Panel Auth
- `ADMIN_USER` / `ADMIN_PASSWORD` – credential pair consumed by `admin-panel/src/auth.ts`. Required for logging into the admin panel.

## Notes
- Defaults in `.env.example` target local development. Change values if ports clash or if you deploy to another host.
- The Docker Compose file uses these variables when building images and mapping ports; restart containers after changing them.