selfhosted
/
coder
mirror of https://github.com/coder/coder.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
coder/docs/quickstart/docker.md

1.7 KiB
Raw Blame History

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!

    $ coder server

  2. Run coder login http://localhost:3000 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.

Next Steps