You can install and run Coder using the official Docker images published on GitHub Container Registry.
Docker is required. See the official installation documentation.
Note that the below steps are only supported on a Linux distribution. If on macOS, please run Coder via the standalone binary.
Coder configuration is defined via environment variables. Learn more about Coder's configuration options.
Note: In order to use cloud-based templates (e.g. Kubernetes, AWS), you must have an external URL that users and workspaces will use to connect to Coder.
For proof-of-concept deployments, you can use Coder's tunnel.
For production deployments, we recommend setting an access URL
Note: Coder runs as a non-root user, we use
--group-addto ensure Coder has permissions to manage Docker via
docker.sock. If the host systems
/var/run/docker.sockis not group writeable or does not belong to the
dockergroup, the above may not work as-is.
Ensure you have an externally-reachable
CODER_ACCESS_URL set. See
troubleshooting templates for
See Docker's official documentation to Manage Docker as a non-root user