Self-host install guide
Run FodyChat on your own Linux server with Docker. The package you received by email is a self-contained bundle โ an image, a compose file and a sample .env. No build step required.
Before you start you need: a domain pointed at your server (DNS A record), a Linux host with Docker (Ubuntu/Debian, 1 GB RAM minimum; Docker Desktop on macOS/Windows), and an AI key (OpenAI or Anthropic) โ the chat won't answer without it.
1. Deploy the package
tar xzf fodychat-selfhost-<version>.tar.gz
cd fodychat-selfhost
docker load < fodychat-selfhost.image.tar
cp .env.selfhost.example .env # fill in
docker compose up -d
docker compose logs -f web License. Paste the SELFHOST_LICENSE from your delivery email into .env. Without a valid token the instance runs as Free (1 project, text, message limit); with it, as Self-host (unlimited + tools). Verify with curl -i http://localhost:4321/ โ 200.
2. HTTPS with Caddy
sudo apt install -y caddy
# /etc/caddy/Caddyfile
chat.example.com {
reverse_proxy 127.0.0.1:4321
} 3. Admin sign-in (Google OAuth)
- console.cloud.google.com โ Credentials โ OAuth client ID โ Web application.
- Authorized redirect URI:
https://<domain>/api/admin/auth/google/callback. - In
.env:GOOGLE_CLIENT_ID,GOOGLE_CLIENT_SECRET,ADMIN_EMAILS(your email).
4. After it's running
- Open
/admin, sign in, and create a project. - Copy the publishable key (
pub_โฆ) and set the allowed origins (your site's domain). - Embed the widget on your site.