Docker

Coder with Docker has the following advantages:

Simple installation (everything is on a single box)
Workspace images are easily configured
Workspaces share resources for burst operations

Requirements

A single macOS or Linux box
A running Docker daemon

Instructions

Install and launch Coder

The Coder server binds to port 3000 by default. Use --address :<port> to customize it!

Use the Coder tunnel for a public URL:
```
coder server
```
Or set an access URL to run entirely locally:
```
coder server --access-url=http://localhost:3000 --address=:3000
```
Run coder login <access url> in a new terminal and follow the interactive instructions to create your user.
Pull the "Docker" example template using the interactive coder templates init:
```
coder templates init
cd docker
```
Push up the template with coder templates create
Open the dashboard in your browser (http://localhost:3000) to create your first workspace:

Then navigate to Templates > docker > Create workspace

Now wait a few moments for the workspace to build... After the first build, the image is cached and subsequent builds will take a few seconds.
Your workspace is ready to go!

Open up a web application or SSH in.
If you want to modify the Docker image or template, edit the files in the previously created ./docker directory, then run coder templates push.

Troubleshooting

Docker-based workspace is stuck in "Connecting..."

Ensure you have an externally-reachable CODER_ACCESS_URL set. See troubleshooting templates for more steps.

Permission denied while trying to connect to the Docker daemon socket

See Docker's official documentation to Manage Docker as a non-root user.

Next Steps