mirror of
https://github.com/coder/coder.git
synced 2025-07-09 11:45:56 +00:00
3cc77d96eb
* feat: Add tunnel by default If an access URL is not specified, we will always tunnel. This is from community-member feedback who exclaimed that it's confusing having the default for `coder server` display a warning message, and I agree. There is very little (maybe none) in running `coder server` without tunnel and without an access URL, so this seems like overall a much better UX. * Update install.sh Co-authored-by: Ben Potter <ben@coder.com> * Update docs/install/packages.md Co-authored-by: Ben Potter <ben@coder.com> * Fix reset pass test * Fix e2e test Co-authored-by: Ben Potter <ben@coder.com>
61 lines
1.7 KiB
Markdown
61 lines
1.7 KiB
Markdown
# 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](../install)
|
|
|
|
The Coder server binds to port 3000 by default. Use `--address :<port>` to customize it!
|
|
|
|
```bash
|
|
$ coder server
|
|
```
|
|
|
|
1. Run `coder login http://localhost:3000` in a new terminal and follow the
|
|
interactive instructions to create your user.
|
|
|
|
1. Pull the "Docker" example template using the interactive `coder templates init`:
|
|
|
|
```bash
|
|
$ coder templates init
|
|
$ cd docker
|
|
```
|
|
|
|
1. Push up the template with `coder templates create`
|
|
1. Open the dashboard in your browser (http://localhost:3000) to create your
|
|
first workspace:
|
|
|
|
<img src="../images/quickstart/docker/login.png">
|
|
|
|
Then navigate to `Templates > docker > Create workspace`
|
|
|
|
<img src="../images/quickstart/docker/create-workspace.png">
|
|
|
|
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.
|
|
|
|
1. Your workspace is ready to go!
|
|
|
|
<img src="../images/quickstart/docker/ides.png">
|
|
|
|
Open up a web application or [SSH in](../ides.md#ssh-configuration).
|
|
|
|
1. 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
|
|
|
|
- [Port-forward](../networking/port-forwarding.md)
|
|
- [Learn more about template configuration](../templates.md)
|
|
- [Configure more IDEs](../ides/web-ides.md)
|