mirror of https://github.com/coder/coder.git
2835bb45e5 | ||
---|---|---|
.github | ||
.vscode | ||
agent | ||
buildinfo | ||
cli | ||
cmd | ||
coderd | ||
codersdk | ||
cryptorand | ||
docs | ||
examples | ||
peer | ||
peerbroker | ||
provisioner | ||
provisionerd | ||
provisionersdk | ||
pty | ||
scripts | ||
site | ||
.gitattributes | ||
.gitignore | ||
.golangci.yaml | ||
.goreleaser.yaml | ||
LICENSE | ||
Makefile | ||
codecov.yaml | ||
coder.env | ||
coder.service | ||
develop.sh | ||
go.mod | ||
go.sum | ||
rules.go |
docs/README.md
Coder
Provision remote development environments with Terraform.
Highlights
- Automate development environments for Linux, Windows, and MacOS in your cloud
- Start writing code with a single command
- Use one of many examples to get started
Getting Started
Install the latest release.
To tinker, start with dev-mode (all data is in-memory, and is destroyed on exit):
$ coder start --dev
To run a production deployment with PostgreSQL:
$ CODER_PG_CONNECTION_URL="postgres://<username>@<host>/<database>?password=<password>" \
coder start
To run as a system service, install with .deb
or .rpm
:
# Edit the configuration!
$ sudo vim /etc/coder.d/coder.env
$ sudo service coder restart
Your First Workspace
In a new terminal, create a new project (eg. Develop in Linux on Google Cloud):
$ coder templates init
$ coder templates create
Create a new workspace and SSH in:
$ coder workspaces create my-first-workspace
$ coder ssh my-first-workspace
Working with Projects
You can edit the Terraform from a sample project:
$ coder templates init
$ cd gcp-linux/
$ vim main.tf
$ coder templates update gcp-linux
Contributing
Read the contributing docs.