coder/docs/quickstart/docker.md

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

1. 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
   

2. Run coder login <access url> in a new terminal and follow the interactive instructions to create your user.

3. Pull the "Docker" example template using the interactive coder templates init:

   coder templates init
   cd docker
   

4. Push up the template with coder templates create

5. 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.

6. Your workspace is ready to go!

   

   Open up a web application or SSH in.

7. 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

• Port-forward
• Learn more about template configuration
• Configure more IDEs