Skip to content
SoulTales Docs

Helpdesk

Chatwoot deployment and operations.

Customer support runs Chatwoot from the helpdesk/ package, deployed to Fly.io.

Dependencies

Section titled “Dependencies”
  • Neon Postgres: primary database
  • Upstash Redis: Sidekiq job queue and cache
  • Cloudflare R2: file attachments (S3-compatible)
  • Mailgun: optional inbound/outbound email

Local development

Section titled “Local development”
Terminal window
pnpm --filter soultales-helpdesk dev

Uses Docker Compose with Postgres and Redis.

Production deploy

Section titled “Production deploy”
Terminal window
pnpm deploy:helpdesk

See helpdesk/README.md for first-time Fly setup, secrets, and worker process configuration.

Widget integration

Section titled “Widget integration”

After deploy, configure the Chatwoot website widget on the dashboard with the production FRONTEND_URL and inbox settings from the Chatwoot admin. The public frontend syncs contact forms via the Chatwoot REST API: it does not embed the live chat widget.

soultales.com Partner portal Partner docs

Overview

Introduction Architecture Environments Platform stack Services & vendors

Frontend

Overview Auth & users Directus integration

Dashboard

Overview Partner flows Billing

Backend

Directus Extensions Deploy on Fly

Operations

Deploy runbooks Secrets Helpdesk

Contributing

Local development Monorepo commands