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)

  1. console.cloud.google.com โ†’ Credentials โ†’ OAuth client ID โ†’ Web application.
  2. Authorized redirect URI: https://<domain>/api/admin/auth/google/callback.
  3. In .env: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, ADMIN_EMAILS (your email).

4. After it's running

  1. Open /admin, sign in, and create a project.
  2. Copy the publishable key (pub_โ€ฆ) and set the allowed origins (your site's domain).
  3. Embed the widget on your site.