Skip to content
/ coder Public

Provision remote development environments via Terraform

License

AGPL-3.0, Unknown licenses found

Licenses found

AGPL-3.0
LICENSE
Unknown
LICENSE.enterprise
Notifications You must be signed in to change notification settings

coder/coder

Repository files navigation

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 server --dev

To run a production deployment with PostgreSQL:

$ CODER_PG_CONNECTION_URL="postgres://<username>@<host>/<database>?password=<password>" \
    coder server

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.