Environments
AtlasCore provides separate environments for development and production use.
Base URLs
| Environment | Base URL | Purpose |
|---|---|---|
| Production | https://api.atlascore.com.au/v1 | Live data with billing active |
| Sandbox | https://sandbox.api.atlascore.com.au/v1 | Development and testing, no billing |
API key prefixes
| Prefix | Environment |
|---|---|
ac_test_ | Sandbox — safe for development, no usage charges |
ac_live_ | Production — real data, metered usage |
Local development
For local development with Docker Compose:
cp .env.example .env
docker compose up --build
| Service | URL | Purpose |
|---|---|---|
| API | http://localhost:8000 | FastAPI app |
| UI | http://localhost:8000/ui | Pack-aware MapLibre client |
| API Reference | http://localhost:8000/api-reference | Scalar interactive docs |
When running locally, auth is disabled by default (AUTH_REQUIRED=false for dev/test/local environments). The API accepts any bearer token and assigns a default tenant context.
Key environment variables
| Variable | Default | Purpose |
|---|---|---|
DATABASE_URL | PostgreSQL connection | Canonical store |
REDIS_URL | Redis connection | Queue backend, cache |
AUTH_REQUIRED | Auto-detected | false for dev/test, true otherwise |
API_KEYS | Unset | Comma-separated bearer token mappings |
See Authentication for auth configuration details.