Skip to main content
Live Agent uses active storage for storing attachments. The default storage option is the local storage on your server, or with an NFS server (preferred way) and CDNs from any cloud provider such as AWS S3, Microsoft Azure and Google Cloud, etc. See below for the additional values required.

Using an NFS Server

AWS

When using AWS, an existing Elastic File System or EFS must be setup. Based on your EFS, fill in the following values:
NameTypeValue
storage.cloudProviderstring"aws"
storage.fileSystemIdstring""
storage.provisionerNamestring""
storage.regionstring""
configmap.ACTIVE_STORAGE_SERVICEstring"local"

Azure

When using Azure, a Network File System or NFS server must be set up. Based on your NFS server, fill in the following values:
NameTypeValue
storage.sizestring"10Gi"
storage.cloudProviderstring"azure"
storage.nfsServerstring""
configmap.ACTIVE_STORAGE_SERVICEstring"local"

Using a CDN

Set the following value to "cdn" to use a Content Delivery network or CDN, and fill in the remaining values based on the provider that you want to use.
NameTypeValue
storage.cloudProviderstring"cdn"

Using Amazon S3

You can start by creating an S3 bucket and IAM user to configure the following details.
NameTypeValue
configmap.ACTIVE_STORAGE_SERVICEstring"amazon"
configmap.S3_BUCKET_NAMEstring""
configmap.AWS_ACCESS_KEY_IDstring""
configmap.AWS_SECRET_ACCESS_KEYstring""
configmap.AWS_REGIONstring""
A secret must be set up for setting the AWS_SECRET_ACCESS_KEY environment variable.
NameTypeValue
storage.secretAccessKey.environmentVariablestring"AWS_SECRET_ACCESS_KEY"
storage.secretAccessKey.existingSecretstring"<secret-name>"
storage.secretAccessKey.existingSecretKeystring"<secret-key>"

Using Google GCS

NameTypeValue
configmap.ACTIVE_STORAGE_SERVICEstring"google"
configmap.GCS_PROJECTstring""
configmap.GCS_BUCKETstring""
A secret must be set up for setting the GCS_CREDENTIALS environment variable.
NameTypeValue
storage.secretAccessKey.environmentVariablestring"GCS_CREDENTIALS"
storage.secretAccessKey.existingSecretstring"<secret-name>"
storage.secretAccessKey.existingSecretKeystring"<secret-key>"
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" : ""
}

Using Microsoft Azure

NameTypeValue
configmap.ACTIVE_STORAGE_SERVICEstring"microsoft"
configmap.AZURE_STORAGE_ACCOUNT_NAMEstring""
configmap.AZURE_STORAGE_CONTAINERstring""
A secret must be set up for setting the AZURE_STORAGE_ACCESS_KEY environment variable.
NameTypeValue
storage.secretAccessKey.environmentVariablestring"AZURE_STORAGE_ACCESS_KEY"
storage.secretAccessKey.existingSecretstring"<secret-name>"
storage.secretAccessKey.existingSecretKeystring"<secret-key>"

Using Amazon S3 Compatible Service

To use an S3 compatible service such as DigitalOcean Spaces, Minio etc..
NameTypeValue
configmap.ACTIVE_STORAGE_SERVICEstring"s3_compatible"
configmap.STORAGE_BUCKET_NAMEstring""
configmap.STORAGE_ACCESS_KEY_IDstring""
configmap.STORAGE_REGIONstring"nyc3"
configmap.STORAGE_ENDPOINTstring"https://nyc3.digitaloceanspaces.com"
A secret must be set up for setting the STORAGE_SECRET_ACCESS_KEY environment variable.
NameTypeValue
storage.secretAccessKey.environmentVariablestring"STORAGE_SECRET_ACCESS_KEY"
storage.secretAccessKey.existingSecretstring"<secret-name>"
storage.secretAccessKey.existingSecretKeystring"<secret-key>"
Set force_path_style to true if using minio.
NameTypeValue
configmap.STORAGE_FORCE_PATH_STYLEbooltrue
A local Persistent Volume Claim (PVC) is available for storage. However, it is not recommended for scaling up deployments as there is only one PVC per deployment.
NameTypeValue
storage.cloudProviderstring"none"
storage.sizestring"10Gi"
I