Configure Cloud Storage

Chatwoot uses Active Storage for storing attachments. The default storage option is local storage on your server, but you can configure cloud providers for better scalability and backup.

It is recommended to use a cloud provider for your Chatwoot storage to ensure proper backup of stored attachments and prevent data loss.

Using Amazon S3

You can get started with Creating an S3 bucket and Create an IAM user to configure the following details. Configure the following env variables.

ACTIVE_STORAGE_SERVICE=amazon
S3_BUCKET_NAME=
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_REGION=

Using Google GCS

Starting with version 2.17+, wrap the GCS_CREDENTIALS environment variable in single quotes.

Configure the following env variables.

ACTIVE_STORAGE_SERVICE=google
GCS_PROJECT=
GCS_CREDENTIALS=
GCS_BUCKET=

The value of the GCS_CREDENTIALS should be a json formatted string containing the following keys.

{
  "type": "service_account",
  "project_id" : "",
  "private_key_id" : "",
  "private_key" : "",
  "client_email" : "",
  "client_id" : "",
  "auth_uri" : "",
  "token_uri" : "",
  "auth_provider_x509_cert_url" : "",
  "client_x509_cert_url" : ""
}

When pasting the credentials to the ENV file, make sure to remove the new lines and paste it into a single line.

GCS_CREDENTIALS={"type": "service_account","project_id": "","private_key_id": "","private_key": "","client_email": "","client_id": "","auth_uri": "","token_uri": "","auth_provider_x509_cert_url": "","client_x509_cert_url": ""}

Using Microsoft Azure

Configure the following env variables.

ACTIVE_STORAGE_SERVICE=microsoft
AZURE_STORAGE_ACCOUNT_NAME=
AZURE_STORAGE_ACCESS_KEY=
AZURE_STORAGE_CONTAINER=

Using Amazon S3 Compatible Service

To use an s3 compatible service such as DigitalOcean Spaces, Minio etc.. Configure the following env variables.

ACTIVE_STORAGE_SERVICE=s3_compatible
STORAGE_BUCKET_NAME=
STORAGE_ACCESS_KEY_ID=
STORAGE_SECRET_ACCESS_KEY=
STORAGE_REGION=nyc3
STORAGE_ENDPOINT=https://nyc3.digitaloceanspaces.com
#set force_path_style to true if using minio
#STORAGE_FORCE_PATH_STYLE=true

Getting Started

Deployment Methods

Cloud Providers

Configuration

Integrations

Maintenance

Runbooks

Others

Supported Providers

Configure Cloud Storage

Using Amazon S3

Using Google GCS

Using Microsoft Azure

Using Amazon S3 Compatible Service

​Configure Cloud Storage

​Using Amazon S3

​Using Google GCS

​Using Microsoft Azure

​Using Amazon S3 Compatible Service

Configure Cloud Storage

Using Amazon S3

Using Google GCS

Using Microsoft Azure

Using Amazon S3 Compatible Service