synced/coder
1
0
Fork 0
mirror of https://github.com/coder/coder.git synced 2025-07-08 11:39:50 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
1d88b9c65c34738d75392b316bc49e93668588e8
coder/docs/quickstart/docker.md
Ammar Bandukwala 4b540b7c42 docs: simplify Docker quickstart (#4257)
2022-09-29 17:55:15 -05:00

2.1 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

    Next, we export the CODER_ADDRESS and CODER_ACCESS_URL environment variables. We can use localhost for the Access URL since the workspaces all run on the same machine. CODER_ADDRESS is where coder server binds while CODER_ACCESS_URL is where it's accessed. We use :7080 to bind to all interfaces.

    $ export CODER_ADDRESS=:7080
$ export CODER_ACCESS_URL=http://localhost:7080
$ coder server --address $CODER_ADDRESS --access-url $CODER_ACCESS_URL

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