2020-10-07 05:29:53 +08:00
# code-server · [!["GitHub Discussions"](https://img.shields.io/badge/%20GitHub-%20Discussions-gray.svg?longCache=true&logo=github&colorB=purple)](https://github.com/cdr/code-server/discussions) [!["Join us on Slack"](https://img.shields.io/badge/join-us%20on%20slack-gray.svg?longCache=true&logo=slack&colorB=brightgreen)](https://cdr.co/join-community) [![Twitter Follow](https://img.shields.io/twitter/follow/CoderHQ?label=%40CoderHQ&style=social)](https://twitter.com/coderhq)
2019-01-08 08:46:19 +08:00
2020-05-18 04:53:08 +08:00
Run [VS Code ](https://github.com/Microsoft/vscode ) on any machine anywhere and access it in the browser.
2019-03-06 09:45:21 +08:00
2020-05-22 10:16:16 +08:00
![Screenshot ](./doc/assets/screenshot.png )
## Highlights
2020-10-30 05:21:47 +08:00
- Code on any device with a consistent development environment
- Use cloud servers to speed up tests, compilations, downloads, and more
- Preserve battery life when you're on the go; all intensive tasks run on your server
2020-05-12 13:46:38 +08:00
2020-05-18 08:47:33 +08:00
## Getting Started
2020-05-12 13:46:38 +08:00
2020-10-30 05:21:47 +08:00
There are two ways to get started:
2020-05-12 13:46:38 +08:00
2020-10-30 05:21:47 +08:00
1. Using the [install script ](./install.sh ), which automates most of the process. The script uses the system package manager (if possible)
2. Manually installing code-server; see [Installation ](./doc/install.md ) for instructions applicable to most use cases
2020-06-05 04:31:01 +08:00
2020-10-30 05:21:47 +08:00
If you choose to use the install script, you can preview what occurs during the install process:
2020-05-20 11:41:28 +08:00
```bash
2020-05-28 03:48:03 +08:00
curl -fsSL https://code-server.dev/install.sh | sh -s -- --dry-run
2020-05-22 03:17:02 +08:00
```
2019-09-19 02:21:38 +08:00
2020-10-30 05:21:47 +08:00
To install, run:
2020-05-12 13:46:38 +08:00
```bash
2020-05-22 05:10:29 +08:00
curl -fsSL https://code-server.dev/install.sh | sh
2020-05-12 13:46:38 +08:00
```
2020-10-30 05:21:47 +08:00
When done, the install script prints out instructions for running and starting code-server.
2020-05-23 03:38:03 +08:00
2020-10-30 05:21:47 +08:00
We also have an in-depth [setup and configuration ](./doc/guide.md ) guide.
2020-05-22 03:17:02 +08:00
2020-10-14 07:25:09 +08:00
### Alpha Program 🐣
2020-10-22 04:45:53 +08:00
2020-11-16 23:50:05 +08:00
We're working on a cloud platform that makes deploying and managing code-server easier. Consider [updating to 3.7.0 ](https://github.com/cdr/code-server/releases/tag/v3.7.0 ) and running code-server with our experimental flag `--link` if you don't want to worry about
2020-10-14 07:25:09 +08:00
2020-10-22 04:45:53 +08:00
- TLS
- Authentication
- Port Forwarding
2020-10-14 07:25:09 +08:00
2020-11-04 07:23:41 +08:00
```bash
$ code-server --link
Proxying code-server to Coder Cloud, you can access your IDE at https://valmar-jon.cdr.co
```
2020-02-19 08:07:01 +08:00
## FAQ
2019-10-24 00:49:05 +08:00
2020-02-19 08:07:01 +08:00
See [./doc/FAQ.md ](./doc/FAQ.md ).
2019-01-08 08:46:19 +08:00
2020-10-30 05:21:47 +08:00
## Want to help?
2020-03-20 05:53:31 +08:00
2020-10-30 05:21:47 +08:00
See [CONTRIBUTING ](./doc/CONTRIBUTING.md ) for details.
2020-03-20 05:53:31 +08:00
2020-06-10 06:10:28 +08:00
## Hiring
2020-10-30 05:21:47 +08:00
We ([@cdr](https://github.com/cdr)) are looking for engineers to help [maintain
code-server](https://jobs.lever.co/coder/e40becde-2cbd-4885-9029-e5c7b0a734b8), innovate on open source, and streamline dev workflows.
2020-06-22 12:55:56 +08:00
2020-06-10 06:10:28 +08:00
Our main office is in Austin, Texas. Remote is ok as long as
2020-06-26 04:33:55 +08:00
you're in North America or Europe.
2020-06-10 06:10:28 +08:00
2020-10-30 05:21:47 +08:00
Please get in [touch ](mailto:jobs@coder.com ) with your resume/GitHub if interested.
2020-08-29 06:39:51 +08:00
2020-07-30 01:37:19 +08:00
## For Organizations
2019-09-27 22:39:29 +08:00
2020-07-30 01:37:19 +08:00
Visit [our website ](https://coder.com ) for more information about remote development for your organization or enterprise.