Docs

Self-Hosting

Run the entire Grovs platform — backend, dashboard, link redirects, storage, and workers — on your own infrastructure with one Docker Compose stack.

Grovs is fully self-hostable. The grovs-io/self-host repository bundles the whole platform — backend, dashboard, PostgreSQL, Redis, object storage, background workers, and a reverse proxy with automatic TLS — into a single Docker Compose stack you bring up with one command on your own server.

Everything self-hosted is off by default in the application code and only activates when GROVS_SELF_HOSTED=true (backend) / NEXT_PUBLIC_SELF_HOSTED=true (dashboard) — which this stack sets for you.

Requirements

  • A Linux server with Docker and Docker Compose v2, ports 80/443 open.
  • Two registrable domains — one for production, one for test — each with its subdomain records plus a wildcard.
  • About 4 vCPU / 8 GB RAM / 80 GB SSD as a comfortable floor (serves ~150–200k monthly users).

Guides

  1. Overview — architecture, what runs, and how it scales.
  2. Deployment — DNS, the one-command stack, first login, and creating your first project.
  3. Configuration — every environment variable, branding / default images, and email.
  4. SDK Configuration — point the mobile SDKs at your server and wire up Universal Links / App Links.

The entire stack comes up with docker compose --profile standalone up -d after you run the bundled setup.sh and set your two domains. No manual database, OAuth, or secret wrangling required.