Configuration

Configuration is environment-driven (.env, .env.example).

Core Django Settings

  • SECRET_KEY
  • DEBUG
  • ALLOWED_HOSTS
  • CSRF_TRUSTED_ORIGINS

Database Settings

  • DATABASE_URL
  • TEST_DATABASE_URL
  • TEST_USE_DATABASE_URL
  • TEST_REUSE_EXISTING_DB

Behavior:

  • Postgres/PostGIS URL selects GeoDjango PostGIS backend
  • Empty DB URL falls back to SpatiaLite
  • TEST_DATABASE_URL uses default Django test DB create/drop flow
  • Set TEST_REUSE_EXISTING_DB=True only for legacy in-place reuse mode
  • PostGIS test create/drop flow may require superuser privileges to run CREATE EXTENSION postgis in fresh test databases

Map Settings

  • DEFAULT_MAP_CENTER_LAT, DEFAULT_MAP_CENTER_LNG
  • DEFAULT_MAP_ZOOM, MIN_MAP_ZOOM
  • UTM_EPSG
  • DEFAULT_TILE_PROVIDER
  • OSM_TILE_URL, SATELLITE_TILE_URL

Raster Overlay Settings

  • RASTER_TILES_ROOT: filesystem root where pre-generated raster XYZ tiles are stored
  • RASTER_TILES_URL: URL prefix used by the raster tile-serving endpoint
  • RASTER_QUERY_ROOT: filesystem root where queryable raster sources are stored for point sampling

Grid Summary Settings

  • GRID_SUMMARY_COARSE_ZOOM_MAX
  • GRID_SUMMARY_FINE_ZOOM_MAX
  • GRID_SUMMARY_COARSE_CELL_METERS
  • GRID_SUMMARY_FINE_CELL_METERS
  • GRID_SUMMARY_MAX_INDIVIDUAL_PARCELS
  • CLUSTERING_CACHE_TIMEOUT

Notes:

  • These values can be overridden at runtime in Django admin via Parcels -> Parcel Map Settings.
  • If no Parcel Map Settings row exists, environment values are used as fallback.

File Upload Limits

  • FILE_UPLOAD_MAX_MEMORY_SIZE
  • DATA_UPLOAD_MAX_MEMORY_SIZE

Security/Production Settings

Applied when DEBUG=False, including:

  • SSL redirect and forwarded host settings
  • secure session/csrf cookies
  • HSTS
  • hardened static storage (CompressedManifestStaticFilesStorage)