Self-Hosting¶

The rest of these docs describe the hosted service at coder.ddev.com. This section is for people who run the coder-ddev templates on their own Coder server, and for the people who operate coder.ddev.com.

What you run¶

A Coder server (v2.13 or later) with a wildcard domain for workspace app URLs.
One or more Docker hosts with Sysbox, so each workspace can run its own Docker daemon without privileged containers.
The workspace image built from image/Dockerfile (published as ddev/coder-ddev on Docker Hub).
One or more of the templates in the repository: freeform, drupal-core and drupal-contrib.

Coder server ── authentication, templates, workspace orchestration
     │
     ▼
Docker host (sysbox-runc)
  └─ workspace container (one per workspace)
       ├─ Docker daemon ── DDEV containers (web, db, router, add-ons)
       ├─ VS Code for Web, Coder agent
       └─ /home/coder (persistent)

Guides¶

Server setup: installing Docker, Sysbox and Coder on a fresh server, and adding capacity.
Operations: building the image, pushing templates, versions, and workspace lifecycle cleanup.
User management: accounts, roles, GitHub organization access, tokens and quotas.
Troubleshooting: server-side problems, debugging tools and recovery.

Template variables¶

Settings that users can’t change are template variables, set when the template is pushed (see the Makefile):

Variable	Default	Description
`workspace_image_registry`	`index.docker.io/ddev/coder-ddev`	Registry and repository of the workspace image
`image_version`	`v0.1`	Image tag; the Makefile passes the contents of the root `VERSION` file
`cpu`	`4`	CPU shares for each workspace
`memory`	`8`	Memory limit in GB for each workspace
`docker_gid`	`988`	GID of the `docker` group
`docker_registry_mirror`	(auto-detect)	Docker registry mirror for the workspaces’ Docker daemons
`enable_adminer`	`false`	`freeform` only: add an Adminer app button for each project

Contributing¶

Developer and contributor guidance, including for AI agents, lives in the repository’s AGENTS.md. Changes are welcome as pull requests to ddev/coder-ddev.