All configuration is via environment variables. In development mode (ENV=development), a .env file in the project root is loaded automatically.
Configuration is parsed using caarlos0/env/v10 struct tags and validated with go-playground/validator/v10 .
Variable
Default
Description
NAME
Veloria Core
Application display name
PORT
9071
HTTP server port
ENV
development
Environment (development or production)
DATA_DIR
/etc/veloria/data
Root directory for source files and indexes
APP_DEBUG
false
Enable debug-level logging
APP_URL
(empty)
Public URL for the application (enables TLS in production)
REDIRECT_DOMAINS
(empty)
Comma-separated legacy domains to redirect to APP_URL
Variable
Default
Description
HTTP_TIMEOUT
2500
HTTP client timeout in milliseconds
HTTP_HANDLER_TIMEOUT
30s
Max time for a handler to complete
HTTP_READ_TIMEOUT
30s
Max time to read request
HTTP_READ_HEADER_TIMEOUT
5s
Max time to read request headers
HTTP_WRITE_TIMEOUT
30s
Max time to write response
HTTP_IDLE_TIMEOUT
60s
Max idle time for keep-alive connections
HTTP_SHUTDOWN_TIMEOUT
10s
Max time for graceful shutdown
HTTP_RATE_LIMIT_ENABLED
true
Enable rate limiting on API routes
Variable
Default
Description
DB_HOST
localhost
PostgreSQL host
DB_PORT
5432
PostgreSQL port
DB_DATABASE
veloria
Database name
DB_USERNAME
root
Database user
DB_PASSWORD
(empty)
Database password
DB_SSLMODE
(auto)
SSL mode. In development defaults to disable, otherwise require. Accepts: disable, require, verify-full, verify-ca, prefer, allow
DB_TIMEZONE
(empty)
Database timezone (defaults to UTC if unset)
DB_CONNECT_TIMEOUT
5
Connection timeout in seconds
DB_PING_TIMEOUT
3s
Ping timeout after connection
DB_MAX_IDLE_CONNS
10
Max idle connections in pool
DB_MAX_OPEN_CONNS
100
Max open connections in pool
DB_CONN_MAX_IDLE_TIME
10m
Max idle time before closing a connection
DB_CONN_MAX_LIFETIME
1h
Max lifetime of a connection
S3 / MinIO (Search Result Storage)
Variable
Default
Description
S3_ENDPOINT
localhost:9000
S3-compatible endpoint
S3_BUCKET
veloria-searches
Bucket for search results
S3_ACCESS_KEY
minioadmin
Access key
S3_SECRET_KEY
minioadmin
Secret key
S3_USE_SSL
false
Use HTTPS for S3 connections
S3_REGION
us-east-1
S3 region
S3_ENSURE_BUCKET
false
Auto-create bucket on startup (auto-enabled in development)
S3_INIT_TIMEOUT
5s
Timeout for S3 initialization
Variable
Default
Description
OAUTH_BASE_URL
(empty)
Base URL for OAuth callbacks
GITHUB_CLIENT_ID
(empty)
GitHub OAuth client ID
GITHUB_CLIENT_SECRET
(empty)
GitHub OAuth client secret
GITLAB_CLIENT_ID
(empty)
GitLab OAuth client ID
GITLAB_CLIENT_SECRET
(empty)
GitLab OAuth client secret
ATLASSIAN_CLIENT_ID
(empty)
Atlassian OAuth client ID
ATLASSIAN_CLIENT_SECRET
(empty)
Atlassian OAuth client secret
SESSION_SECRET
(empty)
Secret for session cookie encryption. Required in production.
Variable
Default
Description
INDEXER_CONCURRENCY
1
Number of parallel indexing goroutines
SEARCH_CONCURRENCY
24
Max concurrent search fan-out workers
Variable
Default
Description
ASPIRE_CLOUD_API_KEY
(empty)
Bearer token for AspireCloud/WordPress API calls
Variable
Default
Description
API_THROTTLE_RPS
10
Outbound API requests per second
API_THROTTLE_BURST
5
Max burst size for outbound API requests
API_THROTTLE_MAX_RETRIES
3
Max retries for throttled API calls
API_THROTTLE_RETRY_DELAY
5s
Delay between retries
MCP (Model Context Protocol)
Variable
Default
Description
MCP_ENABLED
true
Enable the remote MCP server endpoint at /mcp
Variable
Default
Description
OTEL_EXPORTER_TYPE
none
Exporter type (none, otlp, etc.)
OTEL_EXPORTER_OTLP_ENDPOINT
localhost:4317
OTLP collector endpoint
OTEL_EXPORTER_OTLP_INSECURE
true
Use insecure connection to OTLP endpoint
OTEL_TRACE_BATCH_TIMEOUT
5s
Batch timeout for trace export
OTEL_LOG_BATCH_TIMEOUT
5s
Batch timeout for log export
OTEL_ENABLE_RUNTIME_METRICS
true
Collect Go runtime metrics
Variable
Default
Description
RECONNECT_INTERVAL
30s
How often to retry failed service connections
Variable
Default
Description
ACME_EMAIL
(empty)
Email for ACME/Let's Encrypt registration
CLOUDFLARE_API_TOKEN
(empty)
Cloudflare API token for DNS-01 challenges. Required when APP_URL is set in production.
When EnsureDirs() runs at startup, it creates:
$DATA_DIR/
├── plugins/
│ ├── source/ # Extracted plugin source files
│ └── index/ # Search indexes (one directory per slug)
├── themes/
│ ├── source/
│ └── index/
├── cores/
│ ├── source/
│ └── index/
└── certs/ # TLS certificates (production)