Skip to main content

🌐 Setting up Chatwoot - Marketplace

⚠️ All configurations shown in this manual are simple and hypothetical examples. Adaptations may be necessary depending on your environment's topology and structure.

This guide shows how to perform the installation and initial access to Chatwoot installed via the SaveinCloud Marketplace.

📌 What is Chatwoot?​

Chatwoot is an open-source customer support platform that allows centralizing conversations from multiple channels into a single dashboard.
With it, your team can interact with customers via WhatsApp, Facebook, Instagram, Telegram, Email, Webchat and other means, in an integrated and collaborative way.

Additionally, Chatwoot offers features such as:

  • Management of multiple agents and support teams;
  • Creation of shared inboxes;
  • Automation of messages and support flows;
  • Integrations with external APIs to extend functionalities.

On SaveinCloud, Chatwoot can be easily installed via the Marketplace.

Part 1 - Installing Chatwoot via Marketplace​

  1. In the SaveinCloud panel, open the Marketplace tab.
  2. Search for "Chatwoot" and confirm the installation.
  3. Wait for completion and follow the instructions displayed on the screen.

imagem

⚠️ This manual applies to installation via Marketplace. It does not cover manual installation cases on VPS/VMs.

✅ Installation Completed

Congratulations! Chatwoot has been successfully installed by SaveinCloud. You now have a powerful customer support platform configured with:

  • 🔗 Domain Management via Nginx Proxy Manager
  • 🔒 Automatic SSL Certificate for secure connections
  • ↔️ HTTP to HTTPS Redirection

🚀 Next Steps​

  1. Access Chatwoot: Enter through the domain configured in Nginx Proxy Manager.
  2. Configure the system: In the Chatwoot dashboard, customize channels, users, and automation flows.
  3. Verify secure connection: Confirm that the SSL certificate is active in the browser.

🔧 Domain Management with Nginx Proxy Manager​

For domain and SSL adjustments, access Nginx Proxy Manager:

  • URL: [http://Your URL:81](http://Your URL:81)
  • Temporary credentials:

Altere os dados de acesso

🔑 Important: Change the temporary data after the first login.

Custom Domain Configuration​

  1. Create an A record pointing to the public IP or a CNAME to the host.
  2. In Nginx Proxy Manager, go to Proxy Hosts → Add Proxy Host.
  3. In Domain Names, enter the desired domain.
  4. In Forward Hostname/IP, use rails and in Port enter 3000.
  5. Enable Cache Assets and Websockets Support.
  6. In the SSL tab, select Request a New SSL Certificate, enable Force SSL and HTTP/2 Support.

Configure SSL para seu domínio

💡 Tip: Keep Docker and dependencies updated for security and stability.

⚙️ Advanced Customizations​

Access the /home/chatwoot directory for additional adjustments:

  • docker-compose.yaml → Modify containers
  • .env → Configure SMTP, domain, and variables

Acesse seu Chatwoot

Part 2 - Initial Access and Configuration of Chatwoot​

  1. Access the provided URL (example: env-95696.sp1.br.saveincloud.net.br).
  2. Fill in the initial data: Name, Company, Email, etc.
  3. Finish and start using Chatwoot.

imagem

📖 Additional documentation: Chatwoot Self-hosted

🛠️ Troubleshooting​

❌ Chatwoot does not respond on port 3000​

  • Causes: incomplete installation or application stopped.
  • Solution:
    1. Check in the panel if the container is running.
    2. If not, start it manually.
    3. If it persists, access the logs in the panel.

⚠️ Environment variables not applying​

  • Causes: service not restarted or active cache, and need to restart compose to update the .env.

  • Solution: Open WebSSH or access SSH externally and run the following commands:

    cd /home/chatwoot
    docker compose down && docker compose up -d

    Wait for the containers to restart with docker ps

📄 Useful Links​