Configuration
Fluxlix is configured through environment variables defined in the .env file in your install directory. The installer generates this file with sensible defaults; edit it to customize your installation.
After changing any environment variable, restart the affected services with docker compose up -d for changes to take effect.
Core settings
| Variable | Description | Example |
|---|---|---|
APP_URL | Public URL users access Fluxlix at | https://fluxlix.example.com |
APP_PORT | Port the web interface listens on | 3000 |
NODE_ENV | Set to production for production deployments | production |
SECRET_KEY | Random secret used for signing tokens; keep this private | (generate with openssl rand -hex 32) |
Database
| Variable | Description | Example |
|---|---|---|
DB_HOST | PostgreSQL host | postgres or db.example.com |
DB_PORT | PostgreSQL port | 5432 |
DB_NAME | Database name | fluxlix |
DB_USER | Database user | fluxlix |
DB_PASSWORD | Database password | (strong random password) |
If using the bundled PostgreSQL container, these default values are set by the installer and you do not need to change them unless connecting to an external database.
Redis
| Variable | Description | Example |
|---|---|---|
REDIS_URL | Redis connection string | redis://redis:6379 |
For Redis with authentication: redis://:password@redis:6379
Fluxlix sends email for invitations, notifications, and password resets.
| Variable | Description |
|---|---|
SMTP_HOST | SMTP server hostname |
SMTP_PORT | SMTP server port (typically 587 for TLS) |
SMTP_USER | SMTP username |
SMTP_PASSWORD | SMTP password |
SMTP_FROM | From address for outgoing mail |
File storage
By default, Fluxlix stores uploaded files on the local filesystem inside the Docker volume. To use S3-compatible object storage:
| Variable | Description |
|---|---|
STORAGE_DRIVER | Set to s3 to enable S3 storage |
S3_BUCKET | Bucket name |
S3_REGION | AWS region or custom endpoint region |
S3_ACCESS_KEY | Access key ID |
S3_SECRET_KEY | Secret access key |
S3_ENDPOINT | Custom endpoint URL (for non-AWS S3-compatible services) |
AI provider keys
AI provider API keys are managed through the admin UI at Admin > AI Configuration rather than environment variables. See AI Configuration for instructions.
License server
The license server URL is pre-configured and does not need to be changed for standard installations. For air-gapped environments, contact the Fluxlix team for offline license instructions.
Next steps
- Installation — Install Fluxlix if you have not already
- Upgrading — Update to a new version
- AI Configuration — Add AI provider keys via the admin UI