mirror of
https://github.com/coder/coder.git
synced 2025-07-09 11:45:56 +00:00
106 lines
3.2 KiB
Markdown
106 lines
3.2 KiB
Markdown
# Coder
|
|
|
|
[](https://github.com/coder/coder/discussions)
|
|
[](https://coder.com/community)
|
|
[](https://twitter.com/coderhq)
|
|
[](https://codecov.io/gh/coder/coder)
|
|
|
|
Provision remote development environments with Terraform.
|
|
|
|
## Highlights
|
|
|
|
- Automate development environments for Linux, Windows, and macOS
|
|
- Start writing code with a single command
|
|
- Get started quickly using one of the [examples](./examples) provided
|
|
|
|
## Installing Coder
|
|
|
|
Install [the latest release](https://github.com/coder/coder/releases) on a system with
|
|
at least 1 CPU core and 2 GB RAM.
|
|
|
|
To test, start with dev mode (all data is in-memory and is destroyed on exit):
|
|
|
|
```bash
|
|
coder server --dev
|
|
```
|
|
|
|
To run a production deployment with PostgreSQL:
|
|
|
|
```bash
|
|
CODER_PG_CONNECTION_URL="postgres://<username>@<host>/<database>?password=<password>" \
|
|
coder server
|
|
```
|
|
|
|
To run as a system service, install with `.deb` (Debian, Ubuntu) or `.rpm`
|
|
(Fedora, CentOS, RHEL, SUSE):
|
|
|
|
```bash
|
|
# Edit the configuration!
|
|
sudo vim /etc/coder.d/coder.env
|
|
sudo service coder restart
|
|
```
|
|
|
|
Use `coder start --help` to get a complete list of flags and environment
|
|
variables.
|
|
|
|
### Your first workspace
|
|
|
|
In a new terminal, create a template (e.g., a template to **Develop in Linux on
|
|
Google Cloud**):
|
|
|
|
```bash
|
|
coder templates init
|
|
coder templates create
|
|
```
|
|
|
|
Create a workspace and connect to it via SSH:
|
|
|
|
```bash
|
|
coder workspaces create my-first-workspace
|
|
coder ssh my-first-workspace
|
|
```
|
|
|
|
### Modifying templates
|
|
|
|
You can edit the Terraform template using a sample template:
|
|
|
|
```sh
|
|
coder templates init
|
|
cd gcp-linux/
|
|
vim main.tf
|
|
coder templates update gcp-linux
|
|
```
|
|
|
|
## Documentation
|
|
|
|
- [About Coder](./about.md#about-coder)
|
|
- [Why remote development](about.md#why-remote-development)
|
|
- [Why Coder](about.md#why-coder)
|
|
- [What Coder is not](about.md#what-coder-is-not)
|
|
- [Templates](./templates.md)
|
|
- [Manage templates](./templates.md#manage-templates)
|
|
- [Persistent and ephemeral
|
|
resources](./templates.md#persistent-and-ephemeral-resources)
|
|
- [Variables](./templates.md#variables)
|
|
- [Workspaces](./workspaces.md)
|
|
- [Create workspaces](./workspaces.md#create-workspaces)
|
|
- [Connect with SSH](./workspaces.md#connect-with-ssh)
|
|
- [Editors and IDEs](./workspaces.md#editors-and-ides)
|
|
- [Workspace lifecycle](./workspaces.md#workspace-lifecycle)
|
|
- [Updating workspaces](./workspaces.md#updating-workspaces)
|
|
|
|
## Contributing
|
|
|
|
Read the [contributing docs](./CONTRIBUTING.md).
|
|
|
|
## Contributors
|
|
|
|
<!--- Add your row by date (mm/dd/yyyy), most recent date at end of list --->
|
|
|
|
| Name | Start Date | First PR Date |Organization| GitHub User Link |
|
|
| ------------- | :--------: | :-----------: |:----------:| ------------------------------: |
|
|
| Mathias Fredriksson | 04/25/2022 | 04/25/2022 | [Coder](https://github.com/coder) | [mafredri](https://github.com/mafredri) |
|