mirror of
https://github.com/nickyeoman/docker-compose-cookbooks.git
synced 2026-09-04 10:56:23 +00:00
codeandClaude Fable 5
b4375c3e09
Tdarr, Grocy, Dashy, Traefik, Fider, Twenty CRM, Outline, Chatwoot, ComfyUI, Picard, VoidAuth, Tinyauth, Tugtainer, Sencho, Authelia, Mail Archiver, ITFlow, Notifuse, Maybe Finance, DumbBudget, Silverpeas, Portus, Obsidian — all as _dev stacks following repo conventions. Harbor and Exportify moved to 'Apps That Will Not be in the Repo' (installer-generated compose / no published image). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
63 lines
1.7 KiB
Markdown
63 lines
1.7 KiB
Markdown
# Chatwoot
|
||
|
||
## Overview
|
||
|
||
Open-source customer support and live chat platform.
|
||
|
||
## Project Details
|
||
|
||
- **Project Repository:** [GitHub](https://github.com/chatwoot/chatwoot)
|
||
- **Container Image:** [chatwoot/chatwoot](https://hub.docker.com/r/chatwoot/chatwoot)
|
||
- **Documentation:** [chatwoot.com](https://www.chatwoot.com/docs/self-hosted)
|
||
- **Reverse Proxy Port:** `3000`
|
||
|
||
## Getting Started
|
||
|
||
1. Start the container: `docker compose up -d`
|
||
2. Open http://localhost:3000 in your browser
|
||
3. Follow the initial setup wizard to configure the application
|
||
|
||
## Environment Variable Notes
|
||
|
||
CHATWOOT_SECRET_KEY_BASE – generate with `openssl rand -hex 64`
|
||
CHATWOOT_FRONTEND_URL – public URL of the instance
|
||
|
||
## Volume Notes
|
||
|
||
/app/storage – uploaded attachments (shared by rails and sidekiq)
|
||
/var/lib/postgresql/data – PostgreSQL data (pgvector image required)
|
||
|
||
## Network Notes
|
||
|
||
Requires proxy network
|
||
|
||
## Docker Run
|
||
|
||
```bash
|
||
docker run -d \
|
||
--name chatwoot \
|
||
-p 3000:3000 \
|
||
-e SECRET_KEY_BASE=changeme \
|
||
-e FRONTEND_URL=http://localhost:3000 \
|
||
-e POSTGRES_HOST=dbhost -e POSTGRES_USERNAME=chatwoot \
|
||
-e POSTGRES_PASSWORD=pass -e REDIS_URL=redis://redishost:6379 \
|
||
chatwoot/chatwoot:latest bundle exec rails s -p 3000 -b 0.0.0.0
|
||
```
|
||
|
||
## Additional Notes / Gotchas
|
||
|
||
Before first run, prepare the database once:
|
||
`docker compose run --rm chatwoot bundle exec rails db:chatwoot_prepare`
|
||
Chatwoot requires the pgvector Postgres extension, hence the pgvector image.
|
||
|
||
## Dockhand Stack, Deploy from Git
|
||
|
||
Cookbooks Repository
|
||
stackname: chatwoot_dev
|
||
Compose file path: chatwoot_dev/compose.yaml
|
||
Additional env file (optional): chatwoot_dev/sample.env
|
||
|
||
Then "Load" chatwoot_dev/sample.env into the Environmental variables in dockhand
|
||
|
||
Create the Stack
|