Remote development environments on your infrastructure
Go to file
G r e y 2835bb45e5
chore: bump @testing-library/user-event from ^13.5.0 to 14.1.0 (#972)
2022-04-11 20:33:52 +00:00
.github chore: consolidate js, ts/js labels (#957) 2022-04-11 18:29:35 +00:00
.vscode feat: Add buildinfo package to embed version (#840) 2022-04-05 01:35:03 +00:00
agent feat: wrap ssh with coder key (#894) 2022-04-07 22:40:27 +00:00
buildinfo feat: add version to footer (#882) 2022-04-07 12:18:58 -05:00
cli feat: cli: add autostart and autostop commands (#922) 2022-04-08 16:29:07 +00:00
cmd chore: Rename Projects to Templates (#880) 2022-04-06 12:42:40 -05:00
coderd feat: add debug-level request logging (#923) 2022-04-08 14:35:29 +00:00
codersdk feat: wrap ssh with coder key (#894) 2022-04-07 22:40:27 +00:00
cryptorand chore: improve coverage of cryptorand package (#377) 2022-02-28 09:50:55 -08:00
docs fix: rename projects to templates in README (#920) 2022-04-07 17:58:17 -04:00
examples chore: update v1 schema (#643) 2022-04-01 14:42:36 -05:00
peer chore: update to go 1.18 (#628) 2022-03-28 19:14:40 +00:00
peerbroker feat: Add UI for awaiting agent connections (#578) 2022-03-28 19:19:28 -05:00
provisioner fix: Disable Terraform plugin cache on Darwin (#927) 2022-04-08 12:30:31 -05:00
provisionerd chore: Rename Projects to Templates (#880) 2022-04-06 12:42:40 -05:00
provisionersdk chore: remove usage of ioutil (#642) 2022-03-29 14:59:32 -05:00
pty chore: Improve CI builds by caching Go modules (#528) 2022-03-22 17:09:04 -05:00
scripts feat: Initial E2E test framework for v2 (#288) 2022-03-02 09:26:53 -08:00
site chore: bump @testing-library/user-event from ^13.5.0 to 14.1.0 (#972) 2022-04-11 20:33:52 +00:00
.gitattributes chore: Move httpapi, httpmw, & database into `coderd` (#568) 2022-03-25 16:07:45 -05:00
.gitignore chore: configure chromatic snapshot tests (#896) 2022-04-06 17:51:49 -04:00
.golangci.yaml chore: rename .yaml to .yml (#895) 2022-04-06 21:32:59 +00:00
.goreleaser.yaml chore: rename .yaml to .yml (#895) 2022-04-06 21:32:59 +00:00
LICENSE chore: Add license (#841) 2022-04-04 11:55:06 -05:00
Makefile chore: split queries.sql into files by table (#762) 2022-04-01 15:45:23 -05:00
codecov.yaml chore: remove CodeCov annotations (#928) 2022-04-08 15:57:28 -04:00
coder.env feat: Add TLS support (#556) 2022-03-24 14:21:05 -05:00
coder.service feat: Support caching provisioner assets (#574) 2022-03-28 14:57:19 -05:00
develop.sh chore(site): Add XState inspector (#872) 2022-04-04 19:54:41 -04:00
go.mod chore: bump github.com/lib/pq from 1.10.4 to 1.10.5 (#947) 2022-04-11 11:00:37 -05:00
go.sum chore: bump github.com/lib/pq from 1.10.4 to 1.10.5 (#947) 2022-04-11 11:00:37 -05:00
rules.go ci: Replace DataDog CI with custom upload script (#169) 2022-02-07 17:32:32 +00:00

docs/README.md

Coder

"GitHub Discussions" "Join us on Slack" Twitter Follow codecov

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.