Configuration

Configuration

Environment Variables

Required

Variable	Description	Example
SECRET_KEY	JWT + HMAC signing key	openssl rand -hex 32
DATABASE_URL	PostgreSQL async connection	postgresql+asyncpg://user:pass@host:5432/db
MINIO_ENDPOINT	S3 endpoint	minio:9000 or s3.amazonaws.com
MINIO_ACCESS_KEY	S3 access key
MINIO_SECRET_KEY	S3 secret key
REDIS_URL	Redis connection	redis://redis:6379/0

Optional

Variable	Default	Description
MINIO_BUCKET	openrunner	S3 bucket name
MINIO_SECURE	false	Use HTTPS for S3
DEBUG	false	Enable debug logging
API_HOST	0.0.0.0	API bind address
API_PORT	8000	API port
WORKERS	2	Gunicorn workers (prod)

OAuth (optional)

Variable	Description
GOOGLE_CLIENT_ID	Google OAuth client ID
GOOGLE_CLIENT_SECRET	Google OAuth secret
GITHUB_CLIENT_ID	GitHub OAuth client ID
GITHUB_CLIENT_SECRET	GitHub OAuth secret
OIDC_ISSUER_URL	OIDC provider URL
OIDC_CLIENT_ID	OIDC client ID
OIDC_CLIENT_SECRET	OIDC client secret

LDAP (optional)

Variable	Description
LDAP_URL	LDAP server URL
LDAP_BASE_DN	Base DN for searches
LDAP_BIND_DN	Bind DN
LDAP_BIND_PASSWORD	Bind password

LLM / AI Features (optional)

Variable	Description
OPENROUTER_API_KEY	OpenRouter API key — used for Paper Builder, AI chat, section generation. Get one at https://openrouter.ai/keys
OPENROUTER_BASE_URL	Default: https://openrouter.ai/api/v1
OPENAI_API_KEY	OpenAI direct key (fallback if OpenRouter not set)
OPENAI_BASE_URL	Default: https://api.openai.com/v1

Recommended: Use OpenRouter — gives access to all models (GPT-4o, Claude, Mistral, Llama, etc.) with a single key.

Email (optional)

Variable	Description
RESEND_API_KEY	Resend.com API key
RESEND_FROM_EMAIL	From address
SMTP_HOST	SMTP fallback host
SMTP_PORT	SMTP port

SDK Configuration

Environment Variables

Variable	Description
OPENRUNNER_API_KEY	API key (starts with or_)
OPENRUNNER_BASE_URL	Server URL
OPENRUNNER_PROJECT	Default project (org/project)
OPENRUNNER_MODE	online / offline / disabled
OPENRUNNER_SILENT	Suppress console output
OPENRUNNER_TAGS	Comma-separated default tags

CLI Configuration

openrunner login           # Store API key
openrunner init            # Create .openrunner/settings.json
openrunner status          # Show current config
openrunner online/offline  # Toggle mode

Rate Limits

Bucket	Limit	Window
Auth	30 requests	60s
Writes	300 requests	60s
Default	200 requests	60s