Archived
1
0
This repository has been archived on 2024-09-09. You can view files and clone it, but cannot push or open issues or pull requests.
code-server/README.md

78 lines
3.0 KiB
Markdown
Raw Normal View History

2020-10-06 23:29:53 +02: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 01:46:19 +01:00
2021-04-26 23:13:02 +02:00
[![codecov](https://codecov.io/gh/cdr/code-server/branch/main/graph/badge.svg?token=5iM9farjnC)](https://codecov.io/gh/cdr/code-server)
2021-05-10 22:09:44 +02:00
[![See latest docs](https://img.shields.io/static/v1?label=Docs&message=see%20latest%20&color=blue)](https://github.com/cdr/code-server/tree/v3.10.0/docs)
2020-05-17 22:53:08 +02:00
Run [VS Code](https://github.com/Microsoft/vscode) on any machine anywhere and access it in the browser.
2019-03-06 02:45:21 +01:00
2021-02-03 17:32:35 +01:00
![Screenshot](./docs/assets/screenshot.png)
2020-05-22 04:16:16 +02:00
## Highlights
- 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
## Requirements
For a good experience, we recommend at least:
- 1 GB of RAM
- 2 cores
You can use whatever linux distribution floats your boat but in our [guide](./docs/guide.md) we assume Debian on Google Cloud.
2020-05-18 02:47:33 +02:00
## Getting Started
There are three ways you can get started:
1. Using the [install script](./install.sh), which automates most of the process. The script uses the system package manager (if possible)
2021-02-03 17:32:35 +01:00
2. Manually installing code-server; see [Installation](./docs/install.md) for instructions applicable to most use cases
2021-03-09 00:58:43 +01:00
3. Use our one-click buttons and guides to [deploy code-server to a popular cloud provider](https://github.com/cdr/deploy-code-server) ⚡
2020-06-04 22:31:01 +02:00
If you choose to use the install script, you can preview what occurs during the install process:
2020-05-20 05:41:28 +02:00
```bash
2020-05-27 21:48:03 +02:00
curl -fsSL https://code-server.dev/install.sh | sh -s -- --dry-run
```
To install, run:
```bash
2020-05-21 23:10:29 +02:00
curl -fsSL https://code-server.dev/install.sh | sh
```
When done, the install script prints out instructions for running and starting code-server.
2020-05-22 21:38:03 +02:00
2021-02-03 17:32:35 +01:00
We also have an in-depth [setup and configuration](./docs/guide.md) guide.
2021-03-09 00:58:43 +01:00
### code-server --link
2020-10-21 22:45:53 +02:00
2020-11-16 23:18:12 +01:00
We're working on a cloud platform that makes deploying and managing code-server easier.
Consider running code-server with the beta flag `--link` if you don't want to worry about
2020-10-14 01:25:09 +02:00
2020-10-21 22:45:53 +02:00
- TLS
- Authentication
- Port Forwarding
2020-10-14 01:25:09 +02:00
```bash
$ code-server --link
2021-03-17 03:59:30 +01:00
Proxying code-server, you can access your IDE at https://valmar-jon.cdr.co
```
2020-02-19 01:07:01 +01:00
## FAQ
2021-02-03 17:32:35 +01:00
See [./docs/FAQ.md](./docs/FAQ.md).
2019-01-08 01:46:19 +01:00
## Want to help?
2020-03-19 22:53:31 +01:00
2021-02-03 17:32:35 +01:00
See [CONTRIBUTING](./docs/CONTRIBUTING.md) for details.
2020-03-19 22:53:31 +01:00
2020-06-10 00:10:28 +02:00
## Hiring
Interested in [working at Coder](https://coder.com)? Check out [our open positions](https://jobs.lever.co/coder)!
2020-07-29 19:37:19 +02:00
## For Organizations
2019-09-27 16:39:29 +02:00
2020-07-29 19:37:19 +02:00
Visit [our website](https://coder.com) for more information about remote development for your organization or enterprise.