Self-Hosting Overview
Run your own HeySummon instance with full control over data and infrastructure.
Why Self-Host?
| Self-Hosted | Cloud | |
|---|---|---|
| Deploy | Your own server | cloud.heysummon.ai |
| Database | SQLite, PostgreSQL | Managed |
| Control | Full | Managed |
| Cost | Free (your infra) | Free tier |
| Data | Stays on your server | On Vercel |
| Customization | Full source access | None |
Requirements
- Docker ≥ 24.0 with Docker Compose plugin
- ≥ 1 GB RAM (works on Raspberry Pi 4+)
- Optional: account with a connectivity provider (Cloudflare, Tailscale, or Ngrok)
Quick Start
git clone https://github.com/thomasansems/hitlaas-platform.git
cd hitlaas-platform
bash scripts/setup.shThe setup wizard handles everything: connectivity, environment variables, and Docker stack startup.
Docker Image
Pre-built images available on GHCR:
docker pull ghcr.io/thomasansems/hitlaas-platform:latestAvailable for linux/amd64 and linux/arm64 (Raspberry Pi).
Connectivity Options
You need a way to expose your instance to the internet:
| Method | Cost | Custom Domain | Stable URL | Best For |
|---|---|---|---|---|
| Cloudflare Tunnel | Free | ✅ | ✅ | Production |
| Tailscale Funnel | Free | ❌ | ✅ | Internal/team |
| Ngrok | Free (limited) | Paid | ❌ Free | Quick testing |
| Direct | Free | ✅ | ✅ | VPS with public IP |
Next Steps
- Docker Setup — Docker Compose configuration
- Connectivity — Expose your instance
- Setup Wizard — Automated setup
- Azure Deployment — Terraform on Azure
- Environment Variables — Configuration reference