Skip to content

Self-hosted installation

This guide walks you through downloading and installing Operately on your own infrastructure.

If you are still comparing Operately Cloud and self-hosted Operately, start with the self-hosted overview.

Choose a machine to host Operately. For cloud hosting, we recommend DigitalOcean, Linode, or Hetzner.

Minimum requirements:

  • 2GB RAM and 1 CPU (suitable for teams up to 30 people)
  • 8GB RAM and 4 CPUs (recommended for larger teams)

Point a domain to your server. You can use a subdomain (e.g. operately.example.com) or a root domain (e.g. example.com). Configure the DNS records to point to your server’s IP address. If a reverse proxy handles HTTPS, point the domain at the proxy.

Operately runs as a set of Docker containers orchestrated by Docker Compose. Install Docker and Docker Compose for your operating system:

Operately supports email delivery via SendGrid or SMTP.

Download and extract the latest Operately release:

Terminal window
wget -q https://github.com/operately/operately/releases/latest/download/operately-single-host.tar.gz
tar -xf operately-single-host.tar.gz
cd operately

Run the installation script to configure Operately:

Terminal window
./install.sh

The script prompts you for:

  • Public hostname (e.g. operately.example.com)
  • Email delivery (SendGrid, SMTP, or configure later)
  • HTTPS certificates — whether Operately manages certificates; if not, choose the public URL scheme (http or https)

In operately.env, set OPERATELY_HOST to the external hostname alone. Generated links and local file uploads and downloads use this hostname, scheme, and public port.

DeploymentOPERATELY_URL_SCHEMEDefault public portCERT_AUTO_RENEW
Plain HTTPhttp80no
Operately-managed HTTPShttps443yes
HTTPS terminated by a reverse proxyhttps443no
  • OPERATELY_URL_PORT: Set only if users connect on a custom public port.
  • PORT: Internal HTTP listener port (defaults to 4000).
  • Reverse proxy HTTPS: Forward to PORT over HTTP, preserve the original Host header, send X-Forwarded-Proto: https, and handle certificates and HTTPS redirects at the proxy.

Start Operately using Docker Compose:

Terminal window
docker compose up --wait --detach

Operately should now be running on your server. You can access it by navigating to your configured domain (e.g. https://operately.example.com).

After installation, you may want to: