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

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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.