2019-08-01 05:08:37 +07:00
|
|
|
# code-server · [![MIT license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/cdr/code-server/blob/master/LICENSE) [!["Latest Release"](https://img.shields.io/github/release/cdr/code-server.svg)](https://github.com/cdr/code-server/releases/latest) [![Build Status](https://img.shields.io/travis/com/cdr/code-server/master)](https://github.com/cdr/code-server)
|
2019-01-08 07:46:19 +07:00
|
|
|
|
2019-07-13 06:41:56 +07:00
|
|
|
`code-server` is [VS Code](https://github.com/Microsoft/vscode) running on a
|
|
|
|
remote server, accessible through the browser.
|
2019-03-06 08:45:21 +07:00
|
|
|
|
2019-03-07 09:59:43 +07:00
|
|
|
Try it out:
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2019-03-07 09:59:43 +07:00
|
|
|
```bash
|
2020-01-28 01:16:58 +07:00
|
|
|
docker run -it -p 127.0.0.1:8080:8080 -v "$PWD:/home/coder/project" codercom/code-server
|
2019-03-07 09:59:43 +07:00
|
|
|
```
|
|
|
|
|
2019-08-01 05:08:37 +07:00
|
|
|
- **Consistent environment:** Code on your Chromebook, tablet, and laptop with a
|
2020-02-05 02:27:46 +07:00
|
|
|
consistent dev environment. Develop more easily for Linux if you have a
|
|
|
|
Windows or Mac and pick up where you left off when switching workstations.
|
2019-08-01 05:08:37 +07:00
|
|
|
- **Server-powered:** Take advantage of large cloud servers to speed up tests,
|
|
|
|
compilations, downloads, and more. Preserve battery life when you're on the go
|
|
|
|
since all intensive computation runs on your server.
|
2019-03-05 01:31:27 +07:00
|
|
|
|
2019-07-22 22:21:15 +07:00
|
|
|
![Screenshot](/doc/assets/ide.gif)
|
2019-03-05 01:31:27 +07:00
|
|
|
|
2020-02-05 02:27:46 +07:00
|
|
|
## VS Code
|
|
|
|
|
|
|
|
- See [our VS Code readme](./src/vscode) for more information about how
|
|
|
|
code-server and VS Code work together.
|
|
|
|
|
2019-03-05 01:31:27 +07:00
|
|
|
## Getting Started
|
2019-09-19 01:21:38 +07:00
|
|
|
|
|
|
|
### Requirements
|
|
|
|
|
2019-10-30 22:33:07 +07:00
|
|
|
- 64-bit host.
|
|
|
|
- At least 1GB of RAM.
|
|
|
|
- 2 cores or more are recommended (1 core works but not optimally).
|
2020-02-05 02:27:46 +07:00
|
|
|
- Secure connection over HTTPS or localhost (required for service workers and
|
|
|
|
clipboard support).
|
2019-10-30 22:33:07 +07:00
|
|
|
- For Linux: GLIBC 2.17 or later and GLIBCXX 3.4.15 or later.
|
2019-09-19 01:21:38 +07:00
|
|
|
- Docker (for Docker versions of `code-server`).
|
|
|
|
|
2019-04-20 08:20:31 +07:00
|
|
|
### Run over SSH
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2019-04-20 08:22:00 +07:00
|
|
|
Use [sshcode](https://github.com/codercom/sshcode) for a simple setup.
|
2019-04-20 08:20:31 +07:00
|
|
|
|
2019-03-07 09:59:43 +07:00
|
|
|
### Docker
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2019-08-01 05:08:37 +07:00
|
|
|
See the Docker one-liner mentioned above. Dockerfile is at [/Dockerfile](/Dockerfile).
|
2019-03-07 09:59:43 +07:00
|
|
|
|
2019-09-13 22:17:27 +07:00
|
|
|
### Digital Ocean
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2019-09-13 22:17:27 +07:00
|
|
|
[![Create a Droplet](./doc/assets/droplet.svg)](https://marketplace.digitalocean.com/apps/code-server?action=deploy)
|
|
|
|
|
2019-07-24 03:38:00 +07:00
|
|
|
### Binaries
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2019-08-01 05:08:37 +07:00
|
|
|
1. [Download a binary](https://github.com/cdr/code-server/releases). (Linux and
|
2019-09-27 21:39:29 +07:00
|
|
|
OS X supported. Windows coming soon)
|
2019-07-24 03:38:00 +07:00
|
|
|
2. Unpack the downloaded file then run the binary.
|
2019-08-08 23:21:45 +07:00
|
|
|
3. In your browser navigate to `localhost:8080`.
|
2019-01-08 07:46:19 +07:00
|
|
|
|
2019-07-24 03:38:00 +07:00
|
|
|
- For self-hosting and other information see [doc/quickstart.md](doc/quickstart.md).
|
|
|
|
- For hosting on cloud platforms see [doc/deploy.md](doc/deploy.md).
|
2019-03-05 01:31:27 +07:00
|
|
|
|
2019-10-23 23:54:47 +07:00
|
|
|
### Build
|
|
|
|
|
2020-02-05 02:27:46 +07:00
|
|
|
- [VS Code prerequisites](https://github.com/Microsoft/vscode/wiki/How-to-Contribute#prerequisites)
|
2019-10-23 23:54:47 +07:00
|
|
|
|
|
|
|
```shell
|
2020-02-05 02:27:46 +07:00
|
|
|
yarn
|
|
|
|
yarn build
|
|
|
|
node build/out/entry.js # You can run the built JavaScript with Node.
|
|
|
|
yarn binary # Or you can package it into a binary.
|
2019-10-23 23:54:47 +07:00
|
|
|
```
|
|
|
|
|
2020-02-05 02:27:46 +07:00
|
|
|
If changes are made to the patch and you've built previously you must manually
|
|
|
|
reset VS Code then run `yarn patch:apply`.
|
|
|
|
|
2019-10-23 23:49:05 +07:00
|
|
|
## Security
|
|
|
|
|
|
|
|
### Authentication
|
2019-10-25 00:35:26 +07:00
|
|
|
By default `code-server` enables password authentication using a randomly
|
|
|
|
generated password. You can set the `PASSWORD` environment variable to use your
|
|
|
|
own instead or use `--auth none` to disable password authentication.
|
2019-10-23 23:49:05 +07:00
|
|
|
|
|
|
|
Do not expose `code-server` to the open internet without some form of
|
|
|
|
authentication.
|
|
|
|
|
|
|
|
### Encrypting traffic with HTTPS
|
|
|
|
If you aren't doing SSL termination elsewhere you can directly give
|
|
|
|
`code-server` a certificate with `code-server --cert` followed by the path to
|
|
|
|
your certificate. Additionally, you can use certificate keys with `--cert-key`
|
|
|
|
followed by the path to your key. If you pass `--cert` without any path
|
|
|
|
`code-server` will generate a self-signed certificate.
|
|
|
|
|
|
|
|
If `code-server` has been passed a certificate it will also respond to HTTPS
|
|
|
|
requests and will redirect all HTTP requests to HTTPS. Otherwise it will respond
|
|
|
|
only to HTTP requests.
|
|
|
|
|
|
|
|
You can use [Let's Encrypt](https://letsencrypt.org/) to get an SSL certificate
|
|
|
|
for free.
|
|
|
|
|
|
|
|
Do not expose `code-server` to the open internet without SSL, whether built-in
|
|
|
|
or through a proxy.
|
|
|
|
|
2019-07-13 06:41:56 +07:00
|
|
|
## Future
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2020-02-05 02:27:46 +07:00
|
|
|
- **Stay up to date!** Get notified about new releases of `code-server`.
|
2019-03-28 05:05:44 +07:00
|
|
|
![Screenshot](/doc/assets/release.gif)
|
2019-03-15 05:32:18 +07:00
|
|
|
- Electron and Chrome OS applications to bridge the gap between local<->remote.
|
2019-03-23 02:58:13 +07:00
|
|
|
|
2019-04-18 05:18:35 +07:00
|
|
|
## Telemetry
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2019-07-24 03:38:00 +07:00
|
|
|
Use the `--disable-telemetry` flag to completely disable telemetry. We use the
|
|
|
|
data collected to improve code-server.
|
2019-04-18 05:18:35 +07:00
|
|
|
|
2019-03-05 01:31:27 +07:00
|
|
|
## Contributing
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2019-07-17 02:57:02 +07:00
|
|
|
### Development
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2020-02-05 02:27:46 +07:00
|
|
|
- [VS Code prerequisites](https://github.com/Microsoft/vscode/wiki/How-to-Contribute#prerequisites)
|
2019-10-23 05:49:38 +07:00
|
|
|
|
2019-07-24 03:38:00 +07:00
|
|
|
```shell
|
2019-07-17 02:57:02 +07:00
|
|
|
yarn
|
2020-02-05 02:27:46 +07:00
|
|
|
yarn watch # Visit http://localhost:8080 once completed.
|
2019-07-17 02:57:02 +07:00
|
|
|
```
|
|
|
|
|
2019-08-03 07:26:41 +07:00
|
|
|
If you run into issues about a different version of Node being used, try running
|
2019-11-06 02:49:18 +07:00
|
|
|
`npm rebuild` in the VS Code directory.
|
2019-08-03 07:26:41 +07:00
|
|
|
|
2020-02-05 02:27:46 +07:00
|
|
|
If changes are made to the patch and you've built previously you must manually
|
|
|
|
reset VS Code then run `yarn patch:apply`.
|
2019-07-23 04:01:32 +07:00
|
|
|
|
2019-07-17 02:57:02 +07:00
|
|
|
## License
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2019-03-05 01:31:27 +07:00
|
|
|
[MIT](LICENSE)
|
2019-01-08 07:46:19 +07:00
|
|
|
|
2019-03-05 01:31:27 +07:00
|
|
|
## Enterprise
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2019-11-15 00:16:08 +07:00
|
|
|
Visit [our enterprise page](https://coder.com) for more information about our
|
|
|
|
enterprise offering.
|
2019-03-05 03:27:46 +07:00
|
|
|
|
|
|
|
## Commercialization
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2019-07-13 06:41:56 +07:00
|
|
|
If you would like to commercialize code-server, please contact
|
|
|
|
contact@coder.com.
|