Configuration

All configuration is managed through the .env file in the project root.

Application Settings

VariableDefaultDescription
APP_NAMENyrgeApplication name
APP_URL—Full URL of your site (required)
APP_ENVproductionproduction or development
APP_DEBUGfalseShow detailed error messages
APP_SECRET—64-char random string for sessions (required)

Database

SQLite (Default)

DB_DRIVER=sqlite
DB_PATH=storage/nyrge.db

SQLite requires no additional setup. The database file is created automatically during installation.

MySQL / MariaDB

DB_DRIVER=mysql
DB_HOST=localhost
DB_PORT=3306
DB_NAME=nyrge
DB_USER=root
DB_PASS=your_password

Theme

VariableDefaultDescription
THEMEdefaultActive theme directory name

Authentication

VariableDefaultDescription
AUTH_METHODlocallocal or alexiuz_sso
ALEXIUZ_AUTH_HUB—SSO hub URL (for managed hosting)

LLM API Keys

Add API keys for the providers you want to use with AI agents:

ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
GOOGLE_API_KEY=...
DEEPSEEK_API_KEY=...
XAI_API_KEY=...
OLLAMA_BASE_URL=http://localhost:11434

Keys can also be managed through Admin > Settings > LLM Keys where they are stored encrypted in the database.

File Uploads

VariableDefaultDescription
UPLOAD_MAX_SIZE10485760Max upload size in bytes (10MB)
UPLOAD_DIRstorage/uploadsUpload directory path

Credits System (Managed Hosting)

VariableDefaultDescription
USD_CREDITS_ENABLEDfalseEnable credit-based AI billing
USD_CREDITS_SERVICE_NAMEnyrgeService identifier for billing