Quepasa Docs

Configuration

Quepasa is configured via environment variables. Each configuration option is prefixed with QUEPASA__ and then split into sections. Below are the core sections and variables you might need to set.

2.1 Deployment Mode

Variable Description Example Value
QUEPASA__DEPLOYMENT__CLUSTERMODE Controls how Quepasa groups its services and manages state. Possible values include:
- 0: Development mode
- 1: Unreliable mode (ephemeral clustering)
- 2: Reliable mode
1 (Unreliable mode)
  • Development mode (0) is best for local experimentation.
  • Unreliable mode (1) makes it easy to run ephemeral clusters without extra overhead.
  • Reliable mode (2) typically involves a connected database or other persistent storage for production use.

2.2 Database Settings

Variable Description Default
QUEPASA__DATABASE__ENABLED true or false. If true, Quepasa uses a database for persistence. If false, in-memory storage is used (ephemeral). false
QUEPASA__DATABASE__CONNECTIONSTRING The connection string to a supported database (e.g., PostgreSQL). (none)
QUEPASA__DATABASE__ADOINVARIANT The database provider name (e.g., Npgsql for PostgreSQL). Microsoft.Data.SqlClient

When ENABLED is false, no database is used and data is reset on every restart. When ENABLED is true, ensure you provide a valid connection string.

2.3 Client Settings

Variable Description Default
QUEPASA__CLIENT__PRIMARYBACKEND Tells the frontend which backend server to talk to (mostly relevant in ephemeral setups). backend

2.4 Initial Setup

Variable Description Default
QUEPASA__SETUP__SEED Set to true to seed the system with initial data (useful for demos/tests). false