Repository files navigation

Coder creates remote development machines so you can develop your code from anywhere. #coder

Note:Coder is in an alpha state, but any serious bugs are P1 for us soplease report them.

Code more

• Build and test faster
  • Leveraging cloud CPUs, RAM, network speeds, etc.
• Access your environment from any place on any client (even an iPad)
• Onboard instantly then stay up to date continuously

Manage less

• Ensure your entire team is using the same tools and resources
  • Rollout critical updates to your developers with one command
• Automatically shut down expensive cloud resources
• Keep your source code and data behind your firewall

Coder workspaces are represented with Terraform. But, no Terraform knowledge isrequired to get started. We have a database of pre-made templates built into theproduct.

Coder workspaces don't stop at compute. You can add storage buckets, secrets, sidecarsand whatever else Terraform lets you dream up.

Learn more about managing infrastructure.

You can use any Web IDE (code-server,projector,Jupyter, etc.),JetBrains Gateway,VS Code Remote or even a file sync such asmutagen.

We recommend installingthe latestrelease on a system with at least 1CPU core and 2 GB RAM:

1. Download therelease asset appropriate for your operating system

2. Unzip the folder you just downloaded, and move thecoder executable to a location that's on yourPATH

   # ex. MacOS and Linuxmv coder /usr/local/bin

   Windows: seethis guide on adding a folder toPATH

There are a few ways to run Coder:

• To run atemporary deployment, start with dev mode (all data is in-memory and destroyed on exit):

  coder server --dev

• To run aproduction deployment with PostgreSQL:

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

• To run as asystem service, install with.deb (Debian, Ubuntu) or.rpm (Fedora, CentOS, RHEL, SUSE):

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

  macOS and Windows users: You'll need to write your ownconfiguration to run Coder as a system service.

• See theinstallation guide for additional ways to run Coder (e.g., docker-compose)

Usecoder --help to get a complete list of flags and environment variables.

In a new terminal window, run the following to copy a sample template:

coder templates init

Follow the CLI instructions to modify and create the template specific for yourusage (e.g., a template toDevelop in Linux on Google Cloud).

Create a workspace using your template:

coder create --template="yourTemplate"<workspaceName>

Connect to your workspace via SSH:

coder ssh<workspaceName>

You can edit the Terraform template using a sample template:

coder templates initcd gcp-linux/vim main.tfcoder templates update gcp-linux

• About Coder
  • Why remote development
  • Why Coder
  • What Coder is not
  • Comparison: Coder vs. [product]
• Templates
  • Manage templates
  • Persistent and ephemeralresources
  • Parameters
• Workspaces
  • Create workspaces
  • Connect with SSH
  • Editors and IDEs
  • Workspace lifecycle
  • Updating workspaces

Join the community onDiscord andTwitter #coder!

Suggest improvements and report problems

Please filean issue if any information is out of date. Also refer to:What Coder is not.

As of 5/27/22

Read thecontributing docs.

Find our list of contributorshere.