Skip to main content

Chatwoot

Logo Chatwoot App

About​

Chatwoot is an open-source customer engagement suite, an alternative to Intercom, Zendesk, Salesforce Service Cloud etc.

Email inbox configuration​

To configure Chatwoot to use Cloudron mail, add an inbox channel of type email with the following IMAP and SMTP configuration:

Assuming my.cloudron.io is your mail server and support@cloudron.io is your desired support mailbox:

  • Create a mailbox in your Cloudron dashboard for support@cloudron.io

  • Set export MAILER_INBOUND_EMAIL_DOMAIN=<mailbox-domain> in /app/data/env.sh and restart the app. This is the email domain of 'forwarding inbox' inside Chatwoot. Note that you must set this value before you proceed to create an inbox inside Chatwoot.

  • Add inbox channel of type email in Chatwoot

    Create Inbox

  • Configure IMAP

    Imap

  • Configure SMTP

    Smtp

Forwarding Address

The forwarding address displayed by Chatwoot can be safely ignored.

Custom config​

Set custom environment variables in /app/data/env.sh using the File manager. Reboot the app after making any changes.

Rails console​

To access the Chatwoot admin console, use the Web terminal and source the environment first before running rails commands.

# source /app/data/env.sh
# source /run/chatwoot/env.sh
# RAILS_ENV=production bundle exec rails c

Custom helpdesk domain​

To set a custom domain for Helpdesk, add an alias in the Cloudron dashboard:

Alias

Then, set the custom domain inside Chatwoot:

Helpdesk