Configuration
Environment variables reference
All configuration via .env file. See .env.example for template.
Database
PostgreSQL with pgvector is required for AI features (knowledge base search, chatbot).
DB_ENGINE=django.db.backends.postgresql
DB_NAME=safaridesk
DB_USER=postgres
DB_PASSWORD=your-password
DB_HOST=db
DB_PORT=5432Redis
REDIS_HOST=redis
REDIS_PORT=6379Email (SMTP)
EMAIL_HOST=smtp.yourprovider.com
EMAIL_PORT=587
EMAIL_USE_TLS=True
EMAIL_HOST_USER=[email protected]
EMAIL_HOST_PASSWORD=your-password
DEFAULT_FROM_EMAIL=[email protected]
DEFAULT_FROM_NAME=SafariDeskURLs
FRONTEND_URL=https://helpdesk.yourdomain.com
DOMAIN_NAME=yourdomain.com
VITE_API_URL=https://api.yourdomain.com/api/v1Admin Account
Created on first startup:
SUPERUSER_USERNAME=admin
SUPERUSER_PASSWORD=your-password
SUPERUSER_EMAIL=[email protected]AI (Gemini)
GEMINI_API_KEY=your-gemini-api-key
GEMINI_MODEL=gemini-flash-latest
EMBEDDING_MODEL=gemini-embedding-001OAuth (Email Integration)
Gmail
GOOGLE_OAUTH_CLIENT_ID=...
GOOGLE_OAUTH_CLIENT_SECRET=...Outlook
MICROSOFT_OAUTH_CLIENT_ID=...
MICROSOFT_OAUTH_CLIENT_SECRET=...
MICROSOFT_OAUTH_TENANT=your-tenant-idMailgun
MAILGUN_API_KEY=...
MAILGUN_SIGNING_KEY=...