one-click-apps icon indicating copy to clipboard operation
one-click-apps copied to clipboard

Fix Chatwoot deployment issues and improve configuration

Open adfastltda opened this issue 2 months ago • 1 comments

Summary

This PR fixes several deployment issues with the Chatwoot one-click app and improves its configuration to match best practices and official deployment templates.

Changes Made

🔧 Fixed Deployment Issues

  • Replaced dockerfileLines with image and command: This resolves the "invalid reference format" error that occurred during image push when using dockerfileLines. The app now uses the official image directly with custom commands, which is more reliable and avoids build/push issues.

✨ Added Missing Configuration

  • Added essential environment variables:

    • NODE_ENV: production
    • FRONTEND_URL (configured for HTTPS)
    • DEFAULT_LOCALE: en
    • FORCE_SSL: false
    • ENABLE_ACCOUNT_SIGNUP: true
    • REDIS_OPENSSL_VERIFY_MODE: none
    • RAILS_MAX_THREADS: 5
    • TRUSTED_PROXIES: *
    • INSTALLATION_ENV: docker (changed from caprover to match official template)
  • Added persistent storage volumes:

    • /data/storage for data storage
    • /app/storage shared between web and worker services
  • Fixed REDIS_URL format: Updated to include username and password in the URL format: redis://default:password@host:6379

🗄️ Database Update

  • Upgraded PostgreSQL: Changed from postgres:15 to pgvector/pgvector:pg17 to support vector search capabilities (matching the official deployment template)

📝 Version Update

  • Updated default version: Changed from 3.1.1 to v4.0.1 to match the latest stable version

Testing

  • [x] I have tested the template using the method described in README.md thoroughly
  • [x] I have ensured that I put as much default values as possible (except passwords) to ensure minimum effort required for end users to get started
  • [x] I have ensured that I am not using the "latest" tag as this tag is dynamically changing and might break the one-click app. Use a fixed version (v4.0.1)
  • [x] I have made sure that instructions.start and instructions.end are clear and self-explanatory
  • [x] Icon is already present as a png file in the logos directory
  • [x] I've executed the checks by running npm ci && npm run validate_apps && npm run formatter-write
  • [x] I will take responsibility addressing any issues that arises as a result of this PR (maintaining this app)

Related Issues

This PR fixes deployment errors that users were experiencing:

  • "invalid reference format" error during image push
  • Missing environment variables causing runtime errors
  • Missing storage volumes for persistent data

Files Changed

  • public/v4/apps/chatwoot.yml

Notes

All changes were tested and validated. The configuration now matches the official Chatwoot deployment template while maintaining compatibility with CapRover's one-click app system.

adfastltda avatar Nov 05 '25 02:11 adfastltda