# Self-hosting

> Run the whole Grovs platform on your own infrastructure as one Docker Compose stack.

Source: https://docs.grovs.io/docs/self-hosting

## Which edition you run

The open-source stack runs **Grovs Community**: free, MIT-licensed, and the complete links and analytics product for up to 100,000 users. **Grovs Enterprise** is a licensed self-hosted edition with everything in Community plus engagement, revenue, data export and compliance features.

| Feature                                                                                                   | Community           | Enterprise       |
| --------------------------------------------------------------------------------------------------------- | ------------------- | ---------------- |
| [Deep links, deferred deep linking, copy to clipboard](https://docs.grovs.io/docs/links)                  | Yes                 | Yes              |
| [Custom domains and smart banners](https://docs.grovs.io/docs/links/custom-domains)                       | Yes                 | Yes              |
| [Analytics: events, retention, campaigns, referrals, MAUs](https://docs.grovs.io/docs/analytics/overview) | Yes                 | Yes              |
| [Custom dashboards](https://docs.grovs.io/docs/analytics/dashboards)                                      | Yes                 | Yes              |
| [All SDKs, the Links API and the MCP server](https://docs.grovs.io/docs/sdk)                              | Yes                 | Yes              |
| Team members, test and production projects, two-factor sign-in                                            | Yes                 | Yes              |
| [Segments](https://docs.grovs.io/docs/analytics/segments)                                                 | No                  | Yes              |
| [Push, in-app messages, journeys and experiments](https://docs.grovs.io/docs/engagement)                  | No                  | Yes              |
| [Revenue and in-app purchase tracking](https://docs.grovs.io/docs/revenue)                                | No                  | Yes              |
| [Event stream and data exports](https://docs.grovs.io/docs/data)                                          | No                  | Yes              |
| [Audit log, single sign-on and SCIM](https://docs.grovs.io/docs/enterprise)                               | No                  | Yes              |
| [Capacity](https://docs.grovs.io/docs/self-hosting/operate/sizing)                                        | Up to 100,000 users | Sized to you     |
| Support                                                                                                   | GitHub issues       | Contract and SLA |

Pages for Enterprise features say so at the top. [Talk to sales](https://www.grovs.io/contact) about Enterprise.

## What you run

The [`grovs-io/self-host`](https://github.com/grovs-io/self-host) repository bundles the backend, dashboard, PostgreSQL, Redis, ClickHouse, background workers and a reverse proxy with automatic TLS. The application ships as two GHCR images released together under one version, `GROVS_VERSION`:

| Image                        | Runs                                             |
| ---------------------------- | ------------------------------------------------ |
| `ghcr.io/grovs-io/backend`   | API, link redirects, migrations and both workers |
| `ghcr.io/grovs-io/dashboard` | Web dashboard                                    |

The source is open at [grovs-io/backend](https://github.com/grovs-io/backend) and [grovs-io/dashboard](https://github.com/grovs-io/dashboard). [Architecture](https://docs.grovs.io/docs/self-hosting/get-started/architecture) shows every service and how traffic reaches it.

Self-hosted mode turns off billing and public sign-up, removes usage quotas, and lets you invite members with a copyable link instead of email.

## Requirements

| Requirement | Value                                                                                                                      |
| ----------- | -------------------------------------------------------------------------------------------------------------------------- |
| Server      | Linux with Docker and Docker Compose v2, ports `80` and `443` open                                                         |
| Size        | 4 vCPU, 8 GB RAM, 80 GB SSD for up to 100,000 users. See [Sizing](https://docs.grovs.io/docs/self-hosting/operate/sizing). |
| Domain      | One domain you control, with wildcard records. A separate branded links domain is optional.                                |

## Choose a path

- [Try locally](https://docs.grovs.io/docs/self-hosting/get-started/try-locally): Run the full stack on your laptop on `lvh.me`. No domain or DNS needed.
- [Deploy on a server](https://docs.grovs.io/docs/self-hosting/get-started/deployment): The one-command installer on any Linux server with Docker.
- [Deploy on a platform](https://docs.grovs.io/docs/self-hosting/platforms): Coolify, Dokploy, Easypanel, CapRover, Railway or Render.
- [Deploy on a cloud VM](https://docs.grovs.io/docs/self-hosting/clouds): AWS, Google Cloud, Azure, DigitalOcean, Hetzner, Vultr, Akamai or Scaleway.

Setup generates your secrets and the first administrator login. No application build or SMTP is required. Cloud and platform deployments use paid resources in your own account.

- [Docker](https://docs.grovs.io/docs/self-hosting/get-started/try-locally): Try the full stack on your laptop.
- [Your server](https://docs.grovs.io/docs/self-hosting/get-started/deployment): Docker Compose with automatic HTTPS.
- [Coolify](https://docs.grovs.io/docs/self-hosting/platforms/coolify): Import the stack into your Coolify server.
- [Dokploy](https://docs.grovs.io/docs/self-hosting/platforms/dokploy): Manage the Compose stack in Dokploy.
- [Easypanel](https://docs.grovs.io/docs/self-hosting/platforms/easypanel): Import the preview service template. [Get Easypanel template](https://github.com/grovs-io/self-host/tree/main/deploy/catalogs/easypanel/grovs)
- [CapRover](https://docs.grovs.io/docs/self-hosting/platforms/caprover): Import the preview One Click App template. [Get CapRover template](https://raw.githubusercontent.com/grovs-io/self-host/main/deploy/catalogs/caprover/grovs.yml)
- [AWS](https://docs.grovs.io/docs/self-hosting/clouds/aws): Create an EC2 server with CloudFormation. [Open CloudFormation](https://console.aws.amazon.com/cloudformation/home#/stacks/create/template)
- [Google Cloud](https://docs.grovs.io/docs/self-hosting/clouds/gcp): Create a VM with guided Cloud Shell setup. [Open in Cloud Shell](https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Fgrovs-io%2Fself-host&cloudshell_tutorial=deploy%2Fgcp%2Ftutorial.md)
- [Azure](https://docs.grovs.io/docs/self-hosting/clouds/azure): Create an Ubuntu VM from an ARM template. [Deploy to Azure](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fgrovs-io%2Fself-host%2Fmain%2Fdeploy%2Fazure%2Fazuredeploy.json)
- [DigitalOcean](https://docs.grovs.io/docs/self-hosting/clouds/digitalocean): Run the full stack on a Droplet. [Open DigitalOcean Console](https://cloud.digitalocean.com/droplets/new)
- [Hetzner](https://docs.grovs.io/docs/self-hosting/clouds/hetzner): Provision Grovs on an Ubuntu Cloud server. [Open Hetzner Console](https://console.hetzner.com)
- [Vultr](https://docs.grovs.io/docs/self-hosting/clouds/vultr): Run Grovs on a Cloud Compute instance. [Open Vultr Console](https://my.vultr.com/deploy/)
- [Akamai / Linode](https://docs.grovs.io/docs/self-hosting/clouds/akamai): Deploy the Compose stack on a Linode. [Open Akamai / Linode Console](https://cloud.linode.com/linodes/create)
- [Scaleway](https://docs.grovs.io/docs/self-hosting/clouds/scaleway): Install Grovs on an Ubuntu Instance. [Open Scaleway Console](https://console.scaleway.com)
- [Railway](https://docs.grovs.io/docs/self-hosting/platforms/railway): Create the full stack from the Railway template. [Deploy on Railway](https://railway.com/deploy/grovs-community)
- [Render](https://docs.grovs.io/docs/self-hosting/platforms/render): Create the services from a Render Blueprint. [Deploy on Render](https://render.com/deploy?repo=https%3A%2F%2Fgithub.com%2Fgrovs-io%2Fself-host)

## Go to production

Before real traffic arrives, work through the [production checklist](https://docs.grovs.io/docs/self-hosting/operate/production-checklist). It covers DNS and certificates, secrets, email, backups, monitoring, firewall, updates and SDK setup.

## How updates work

Backend and dashboard always run the same release. Pin a numbered version, then pull, run migrations and restart. See [Upgrades](https://docs.grovs.io/docs/self-hosting/operate/upgrades) and [Images and releases](https://docs.grovs.io/docs/self-hosting/configure/images).
