Chatwoot/docs/development/project-setup/environment-variables.md

path	title
/docs/environment-variables	Environment Variables

Database configuration

Use the following values in database.yml which lives inside config directory.

development:
  <<: *default
  username: postgres
  password:
  database: chatwoot_dev

We use dotenv-rails gem to manage the environment variables. There is a file called env.example in the root directory of this project with all the environment variables set to empty value. You can set the correct values as per the following options. Once you set the values, you should rename the file to .env before you start the server.

Configure FB Channel

To use FB Channel, you have to create an Facebook app in developer portal. You can find more details about creating FB channels here

FB_VERIFY_TOKEN=
FB_APP_SECRET=
FB_APP_ID=

Configure emails

For development, you don't need an email provider. Chatwoot uses letter-opener gem to test emails locally

Configure frontend URL

Provide the following value as frontend url

FRONTEND_URL='http://localhost:3000'

Configure storage

Chatwoot currently supports only S3 bucket as storage. You can read Creating an S3 bucket and Create an IAM user to configure the following details.

S3_BUCKET_NAME=
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_REGION=

Configure Redis URL

For development, you can use the following url to connect to redis.

REDIS_URL='redis:://127.0.0.1:6379'

Configure Postgres host

You can set the following environment variable to set the host for postgres.

POSTGRES_HOST=localhost

For production and testing you have the following variables for defining the postgres database, username and password.

POSTGRES_DATABASE=chatwoot_production
POSTGRES_USERNAME=admin
POSTGRES_PASSWORD=password