mirror of https://github.com/coder/coder.git
7833c24779 | ||
---|---|---|
.github | ||
.vscode | ||
agent | ||
cli | ||
cmd | ||
coderd | ||
codersdk | ||
cryptorand | ||
examples | ||
peer | ||
peerbroker | ||
provisioner | ||
provisionerd | ||
provisionersdk | ||
pty | ||
scripts | ||
site | ||
.gitattributes | ||
.gitignore | ||
.golangci.yml | ||
.goreleaser.yml | ||
LICENSE | ||
Makefile | ||
README.md | ||
codecov.yml | ||
coder.env | ||
coder.service | ||
develop.sh | ||
go.mod | ||
go.sum | ||
rules.go |
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 projects init
$ coder projects 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 projects init
$ cd gcp-linux/
$ vim main.tf
$ coder projects update gcp-linux
Development
The code structure is inspired by Basics of Unix Philosophy and Effective Go.
Coder requires Go 1.18+, Node 14+, and GNU Make.
make bin
builds binariesmake install
installs binaries to$GOPATH/bin
make test
make release
dry-runs a new release./develop.sh
hot-reloads for frontend development