# uMap

uMap is a tool for creating and sharing custom maps using OpenStreetMap as the base layer.

## Dependencies

- **PostgreSQL** (with PostGIS extension) - Database for storing maps and geographic data

## Configuration

Key settings in `config.yaml`:

- **domain** - Where uMap will be accessible
- **storage** - Persistent volume size (default: `2Gi`)
- **db.name** - Database name (default: `umap`)

## First-Time Setup

1. Add and deploy the app:
   ```bash
   wild app add umap
   wild app deploy umap
   ```

2. Create a superuser account:
   ```bash
   kubectl exec -n umap deploy/umap -- umap createsuperuser
   ```

3. Log in at `/en/login/` with the credentials you just created.

4. Create maps by clicking **Create a map** on the homepage — no account is required for anonymous map creation by default.

## Notes

- uMap uses PostGIS for geographic queries — the db-init job installs the PostGIS extension automatically
- The Django `secretKey` is auto-generated in `secrets.yaml`
- Maps can be made public, unlisted, or private
- The admin panel is at `/admin/` for managing users and content