Environment configuration

Global settings for wanderer can be adjusted via environment variables. If you deployed wanderer with docker you can change the environment variables directly in the docker-compose.yaml. If you deployed wanderer on bare-metal you can change the environment variables in the launch script.

Common

These variables are shared between all three services.

Environment Variable	Description	Default
MEILI_URL	IP or hostname (including the port) of your meilisearch instance	http://search:7700
MEILI_MASTER_KEY	Master API key for your meilisearch instance	vODkljPcfFANYNepCHyDyGjzAMPcdHnrb6X5KyXQPWo

Meilisearch

Since we use an unmodified installation of meilisearch you can use all variables listed in meilisearch’s documentation. You can find a full list over here.

Environment Variable	Description	Default
MEILI_NO_ANALYTICS	Disable meilisearch telemetry	true

Pocketbase

Environment Variable	Description	Default
ORIGIN	Public IP or hostname (including the port) of your wanderer frontend (must be the same as in the frontend config)	http://localhost:3000
POCKETBASE_ENCRYPTION_KEY	Valid 32 character AES key. Used to encrypt secrets
POCKETBASE_CRON_SYNC_SCHEDULE	Valid cron expression. Sets how often installed plugins are synced	0 2 ** *
POCKETBASE_SMTP_ENABLED	Enables or disables SMTP functionality. Accepted values are true or false	false
POCKETBASE_SMTP_SENDER_ADDRESS	The email address used as the “From” address in outgoing emails
POCKETBASE_SMTP_SENDER_NAME	The display name shown as the sender in outgoing emails
POCKETBASE_SMTP_HOST	The hostname or IP address of the SMTP server
POCKETBASE_SMTP_PORT	The port number used to connect to the SMTP server
POCKETBASE_SMTP_USERNAME	The username used to authenticate with the SMTP server
POCKETBASE_SMTP_PASSWORD	The password used to authenticate with the SMTP server
REGION_ARCHIVE_CRON_SCHEDULE	Valid cron expression (UTC). Sets when offline region archives are rebuilt	0 3 * * *
REGION_ARCHIVE_EXTRACT_TIMEOUT	Maximum duration a single region archive extraction may take, as a Go duration string (e.g. 45m)	30m

Plugins are not configured through an environment variable. See Plugin installation for installing runtime plugin bundles and configuring self-hosted connector trust settings.

Frontend

Environment Variable	Description	Default
ORIGIN	Public IP or hostname (including the port) of your wanderer instance	http://localhost:3000
BODY_SIZE_LIMIT	Maximum allowed upload size	Infinity
PUBLIC_POCKETBASE_URL	IP or hostname (including the port) of your pocketbase instance	http://db:8090
PUBLIC_DISABLE_SIGNUP	Disables signup option for new users	false
PUBLIC_PRIVATE_INSTANCE	Setting this to true will block visitors from viewing content without an account	false
PUBLIC_MAP_MAX_POLYLINES	Maximum number of polylines (route previews) to show simultaneously on the map, based on result density	100
UPLOAD_FOLDER	Folder from which wanderer auto-uploads trails	/app/uploads
UPLOAD_USER	Username for the account with which wanderer auto-uploads trails
UPLOAD_PASSWORD	Password for the account with which wanderer auto-uploads trails

Map tiles & assets

These variables configure where the mobile app loads map vector tiles, fonts (glyphs), and sprites from. They are set on the web service. See Custom map tiles & assets for details.

Environment Variable	Description	Default
TILE_SERVER_URL	Vector tile URL template ({z}/{x}/{y}) served to the mobile app	Protomaps API (requires PROTOMAPS_API_KEY)
PROTOMAPS_API_KEY	API key for the default Protomaps tile service; only used when TILE_SERVER_URL is unset
MAP_ASSETS_URL	Base URL for map fonts (glyphs) and sprites	https://protomaps.github.io/basemaps-assets

Geocoding & Routing

These variables configure server-side requests to Valhalla, Nominatim and Overpass.

Environment Variable	Description	Default
VALHALLA_URL	Valhalla API URL used for auto-routing and elevation data	https://valhalla1.openstreetmap.de
NOMINATIM_URL	Nominatim API URL used for (reverse) geocoding	https://nominatim.openstreetmap.org
OVERPASS_API_URL	Overpass API URL used for map points of interest	https://overpass-api.de

When *_URL is unset, the backend falls back to legacy PUBLIC_*_URL.

Custom CA certificates

If your API endpoints use certificates signed by a private CA, add the CA bundle and set NODE_EXTRA_CA_CERTS for the web service.

Environment Variable	Description	Default
NODE_EXTRA_CA_CERTS	Path to an additional CA bundle used by Node.js TLS connections

Example (docker-compose.yml):

services:
  web:
    environment:
      NODE_EXTRA_CA_CERTS: /etc/ssl/private-ca/ca.pem
    volumes:
      - ./certs/ca.pem:/etc/ssl/private-ca/ca.pem:ro

Provider plugin connector CAs are configured per connector when a plugin supports custom TLS. They are not read from NODE_EXTRA_CA_CERTS.