2022-03-28 20:21:00 +00:00
# Coder
2022-01-04 02:54:27 +00:00
2022-04-26 17:10:50 +00:00
[!["Join us on
2022-09-03 06:16:57 +00:00
Discord"](https://img.shields.io/badge/join-us%20on%20Discord-gray.svg?longCache=true& logo=discord& colorB=green)](https://coder.com/chat?utm_source=github.com/coder/coder& utm_medium=github& utm_campaign=readme.md)
2022-07-29 18:39:30 +00:00
[![codecov ](https://codecov.io/gh/coder/coder/branch/main/graph/badge.svg?token=TNLW3OAP6G )](https://codecov.io/gh/coder/coder)
2022-08-08 17:16:40 +00:00
[![Go Reference ](https://pkg.go.dev/badge/github.com/coder/coder.svg )](https://pkg.go.dev/github.com/coder/coder)
2022-04-26 17:10:50 +00:00
[![Twitter
2022-08-08 18:17:38 +00:00
Follow](https://img.shields.io/twitter/follow/coderhq?label=%40coderhq& style=social)](https://twitter.com/coderhq)
2022-01-03 18:52:07 +00:00
2022-06-08 15:37:03 +00:00
Coder creates remote development machines so your team can develop from anywhere.
2022-01-04 02:54:27 +00:00
2022-05-25 00:40:57 +00:00
< p align = "center" >
< img src = "./docs/images/hero-image.png" >
< / p >
2022-05-06 01:09:27 +00:00
2022-05-25 00:40:57 +00:00
**Manage less**
2022-05-24 17:59:20 +00:00
2022-05-25 00:40:57 +00:00
- 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
2022-06-08 15:37:03 +00:00
**Code more**
2022-05-25 00:40:57 +00:00
2022-06-08 15:37:03 +00:00
- 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
2022-05-25 00:40:57 +00:00
2022-06-08 15:37:03 +00:00
## Getting Started
2022-01-03 18:52:07 +00:00
2022-06-08 15:37:03 +00:00
> **Note**:
2022-07-29 18:39:30 +00:00
> Coder is in a beta state. [Report issues here](https://github.com/coder/coder/issues/new).
2022-01-11 21:05:49 +00:00
2022-06-19 20:49:42 +00:00
The easiest way to install Coder is to use our [install script ](https://github.com/coder/coder/blob/main/install.sh ) for Linux and macOS.
2022-02-11 04:32:00 +00:00
2022-06-19 20:49:42 +00:00
To install, run:
2022-02-09 21:46:46 +00:00
2022-06-19 20:49:42 +00:00
```bash
curl -L https://coder.com/install.sh | sh
2022-06-01 19:15:09 +00:00
```
2022-03-16 03:55:21 +00:00
2022-06-19 20:49:42 +00:00
You can preview what occurs during the install process:
2022-03-16 03:55:21 +00:00
2022-06-19 20:49:42 +00:00
```bash
curl -L https://coder.com/install.sh | sh -s -- --dry-run
2022-06-01 19:15:09 +00:00
```
2022-03-16 03:55:21 +00:00
2022-06-19 20:49:42 +00:00
You can modify the installation process by including flags. Run the help command for reference:
```bash
curl -L https://coder.com/install.sh | sh -s -- --help
```
2022-09-08 19:41:00 +00:00
> See [install](docs/install) for additional methods.
2022-06-19 20:49:42 +00:00
2022-08-15 09:32:22 +00:00
Once installed, you can start a production deployment< sup > 1< / sup > with a single command:
2022-05-27 18:10:54 +00:00
2022-06-01 19:15:09 +00:00
```sh
2022-06-15 21:02:18 +00:00
# Automatically sets up an external access URL on *.try.coder.app
2022-10-07 13:05:56 +00:00
coder server
2022-06-15 21:02:18 +00:00
# Requires a PostgreSQL instance and external access URL
coder server --postgres-url < url > --access-url < url >
2022-06-01 19:15:09 +00:00
```
2022-03-16 03:55:21 +00:00
2022-08-15 09:32:22 +00:00
> <sup>1</sup> The embedded database is great for trying out Coder with small deployments, but do consider using an external database for increased assurance and control.
2022-06-15 14:16:43 +00:00
Use `coder --help` to get a complete list of flags and environment variables. Use our [quickstart guide ](https://coder.com/docs/coder-oss/latest/quickstart ) for a full walkthrough.
2022-04-01 18:48:45 +00:00
2022-04-26 17:10:50 +00:00
## Documentation
2022-06-15 14:16:43 +00:00
Visit our docs [here ](https://coder.com/docs/coder-oss ).
2022-05-30 19:19:48 +00:00
2022-05-27 16:34:03 +00:00
## Comparison
2022-06-16 14:46:01 +00:00
Please file [an issue ](https://github.com/coder/coder/issues/new ) if any information is out of date. Also refer to: [What Coder is not ](https://coder.com/docs/coder-oss/latest/index#what-coder-is-not ).
2022-05-27 16:34:03 +00:00
| Tool | Type | Delivery Model | Cost | Environments |
| :---------------------------------------------------------- | :------- | :----------------- | :---------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Coder ](https://github.com/coder/coder ) | Platform | OSS + Self-Managed | Pay your cloud | All [Terraform ](https://www.terraform.io/registry/providers ) resources, all clouds, multi-architecture: Linux, Mac, Windows, containers, VMs, amd64, arm64 |
| [code-server ](https://github.com/cdr/code-server ) | Web IDE | OSS + Self-Managed | Pay your cloud | Linux, Mac, Windows, containers, VMs, amd64, arm64 |
| [Coder (Classic) ](https://coder.com/docs ) | Platform | Self-Managed | Pay your cloud + license fees | Kubernetes Linux Containers |
| [GitHub Codespaces ](https://github.com/features/codespaces ) | Platform | SaaS | 2x Azure Compute | Linux containers |
---
2022-06-08 15:37:03 +00:00
_Last updated: 5/27/22_
## Community and Support
2022-09-06 08:58:27 +00:00
Join our community on [Discord ](https://coder.com/chat?utm_source=github.com/coder/coder&utm_medium=github&utm_campaign=readme.md ) and [Twitter ](https://twitter.com/coderhq )!
2022-06-08 15:37:03 +00:00
[Suggest improvements and report problems ](https://github.com/coder/coder/issues/new/choose )
2022-05-27 16:34:03 +00:00
2022-04-06 17:26:17 +00:00
## Contributing
2022-01-11 21:05:49 +00:00
2022-09-03 06:18:04 +00:00
If you're using Coder in your organization, please try to add your company name to the [ADOPTERS.md ](./ADOPTERS.md ). It really helps the project to gain momentum and credibility. It's a small contribution back to the project with a big impact.
2022-06-15 14:16:43 +00:00
Read the [contributing docs ](https://coder.com/docs/coder-oss/latest/CONTRIBUTING ).
2022-04-27 11:48:45 +00:00
2022-08-11 14:35:51 +00:00
Find our list of contributors [here ](https://github.com/coder/coder/graphs/contributors ).