mirror of
https://github.com/coder/coder.git
synced 2025-07-12 00:14:10 +00:00
4f0f216015
For some reason, CI hung for ~6hours last night on `main`. https://github.com/coder/coder/runs/5982978236?check_suite_focus=true The fact that it went this long is bad, but it should have cancelled much earlier.
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
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.