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

Installing Coder

Install the latest release on a system with at least 2 CPU cores and 2 GB RAM.

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 (Debian, Ubuntu) or .rpm (Fedora, CentOS, RHEL, SUSE):

# Edit the configuration!
$ sudo vim /etc/coder.d/coder.env
$ sudo service coder restart

Reference coder start --help for a complete list of flags and environment variables.

Your First Workspace

In a new terminal, create a new template (eg. Develop in Linux on Google Cloud):

$ coder templates init
$ coder templates create

Create a new workspace and connect via SSH:

$ coder workspaces create my-first-workspace
$ coder ssh my-first-workspace

Modifying Templates

You can edit the Terraform from a sample template:

$ coder templates init
$ cd gcp-linux/
$ vim main.tf
$ coder templates update gcp-linux

Documentation

• About Coder
  • Why remote development
  • Why Coder
  • What Coder is not
• Templates
  • Manage templates
  • Persistent and ephemeral resources
  • Variables
• Workspaces
  • Create workspaces
  • Connect with SSH
  • Editors and IDEs
  • Workspace lifecycle
  • Updating workspaces

Contributing

Read the contributing docs.