Chatwoot should be configured for ticketing workflow integrity, SLA policy enforcement, and secure customer data handling.
Download the official environment template:
wget -O .env https://raw.githubusercontent.com/chatwoot/chatwoot/develop/.env.example
# Application
FRONTEND_URL=https://chatwoot.example.com
SECRET_KEY_BASE=generate-with-rails-secret-keygen
# Database (PostgreSQL 12+ minimum, 16+ recommended for pgvector AI features)
POSTGRES_HOST=postgres
POSTGRES_USERNAME=chatwoot
POSTGRES_PASSWORD=replace-with-strong-password
POSTGRES_DB=chatwoot
# Redis (6+ required)
REDIS_URL=redis://redis:6379
# Runtime
RAILS_ENV=production
NODE_ENV=production
INSTALLATION_ENV=docker
# Active Record Encryption (REQUIRED for MFA/2FA)
# Generate with: rails db:encryption:init
ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY=generate-me
ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY=generate-me
ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT=generate-me
# Email (SMTP)
SMTP_ADDRESS=smtp.example.com
SMTP_PORT=587
SMTP_USERNAME=chatwoot@example.com
SMTP_PASSWORD=smtp-password
MAILER_SENDER_EMAIL=chatwoot@example.com
# File Storage (default: local, options: amazon, google, azure)
STORAGE_SERVICE=local
# WhatsApp Integration
WHATSAPP_API_KEY=your-api-key
# Rate Limiting
RATE_LIMIT_WINDOW=10
RATE_LIMIT_REQUESTS=100
Back up the following:
/app/storage) for attachmentsRestore validation: Test restore with one inbound ticket, one assignment, and one customer reply workflow.
Any questions?
Feel free to contact us. Find all contact information on our contact page.