--- title: "Deploy Chaskiq Self-Hosted (Docker)" description: "Step-by-step guide to self-hosting Chaskiq with Docker Compose. " --- # Deploy Chaskiq Open source conversational marketing platform alternative to Intercom and Drift.
⭐ 4.0k stars 📜 GPL-3.0 🔴 Advanced ⏱ ~20 minutes
🚀 Deploy on DigitalOcean ($200 Free Credit)
## What You'll Get A fully working Chaskiq instance running on your server. Your data stays on your hardware — no third-party access, no usage limits, no surprise invoices. ## Prerequisites - A server with Docker and Docker Compose installed ([setup guide](/quick-start/choosing-a-server)) - A domain name pointed to your server (optional but recommended) - Basic terminal access (SSH) ## The Config Create a directory for Chaskiq and add this `docker-compose.yml`: ```yaml # ------------------------------------------------------------------------- # 🚀 Created and distributed by The AltStack # 🌍 https://thealtstack.com # ------------------------------------------------------------------------- version: '3.8' services: chaskiq: image: chaskiq/chaskiq:latest container_name: chaskiq restart: unless-stopped ports: - "3000:3000" ``` ## Let's Ship It ```bash # Create a directory mkdir -p /opt/chaskiq && cd /opt/chaskiq # Create the docker-compose.yml (paste the config above) nano docker-compose.yml # Pull images and start docker compose up -d # Watch the logs docker compose logs -f ``` ## Post-Deployment Checklist - [ ] Service is accessible on the configured port - [ ] Admin account created (if applicable) - [ ] Reverse proxy configured ([Caddy guide](/concepts/reverse-proxies)) - [ ] SSL/HTTPS working - [ ] Backup script set up ([backup guide](/concepts/backups)) - [ ] Uptime monitor added ([Uptime Kuma](/deploy/uptime-kuma)) ## The "I Broke It" Section **Container won't start?** ```bash docker compose logs chaskiq | tail -50 ``` **Port already in use?** ```bash # Find what's using the port lsof -i :PORT_NUMBER ``` **Need to start fresh?** ```bash docker compose down -v # ⚠️ This deletes volumes/data! docker compose up -d ``` ## Going Further - [Chaskiq on AltStack Directory](https://thealtstack.com/alternative-to/chaskiq) - [Chaskiq Self-Hosted Guide](https://thealtstack.com/self-hosted/chaskiq) - [Official Documentation](https://chaskiq.io) - [GitHub Repository](https://github.com/chaskiq/chaskiq)