Self-host

Run OpenD yourself

OpenD is open source under the MIT license. One image runs every role, so the smallest install is the app, a worker and Postgres.

OpenD on GitHub Read the docs

Quick start

Up and running with one script

On a machine with Docker and Node 22, the setup script checks prerequisites, writes generated secrets, creates a private GitHub App, seeds your first organisation and starts Docker Compose.

  • Safe to run again: it never changes a value already set
  • A non-interactive mode for scripted installs
  • Polling mode when GitHub cannot reach your server
  • S3-compatible storage for split web and worker services
git clone https://github.com/desktopmachineshop/OpenD.git
cd OpenD
node deploy/setup.mjs

Guides

Everything is documented in the repository

  • Self-hosting

    SSO, a TLS reverse proxy, backups, upgrades and hardening.

  • Railway

    Web, worker, Postgres and a bucket as Railway services.

  • OpenD documentation

    Getting started, authoring, help, PDFs and every reference.

Compare

Self-hosted or managed?

Self-hosted compared with managed
Self-hosted Managed OpenD
Software OpenD, MIT licensed OpenD, MIT licensed
Infrastructure Your servers, Docker Compose or Railway A dedicated instance we run
Setup A setup script, then a GitHub App and a seed file Pay, and we provision it
Upgrades and backups You Us
Reader SSO and in-app help You configure them Configured with you (Team plan up)
Cost Free software; you pay for hosting A monthly subscription

See managed plans

Publish docs that fit every reader

Bring your DITA repository. We will have your instance running in minutes.

Get started See our docs