VS Code in the browser
Go to file
Asher db54f78e8e
Implement automatic updates
2020-02-14 15:58:39 -06:00
.github Remvoe question issue template 2020-02-03 11:35:18 -06:00
doc Update fail2ban configuration 2019-11-14 11:14:27 -06:00
lib Update VS Code to 1.42.0 2020-02-13 11:55:15 -06:00
scripts Simplify frontend 2020-02-13 20:10:14 -06:00
src Implement automatic updates 2020-02-14 15:58:39 -06:00
test Implement cli parser 2020-02-07 14:43:08 -06:00
typings/httpolyglot Implement new structure 2020-02-04 14:31:44 -06:00
.dockerignore Remove unused Docker step from CI script 2020-01-15 13:22:42 -06:00
.drone.yml Remove 32 bit arm builds from CI 2020-02-04 16:01:00 -06:00
.editorconfig Implement new structure 2020-02-04 14:31:44 -06:00
.eslintrc.yaml Simplify frontend 2020-02-13 20:10:14 -06:00
.gitignore Update VS Code to 1.42.0 2020-02-13 11:55:15 -06:00
.gitmodules Implement new structure 2020-02-04 14:31:44 -06:00
.node-version Update Node to 12.14.0 2020-01-08 16:30:44 -06:00
.npmrc Fix different node binary warning 2019-07-18 18:09:17 -05:00
.prettierrc.yaml Implement new structure 2020-02-04 14:31:44 -06:00
.stylelintrc.yaml Implement new structure 2020-02-04 14:31:44 -06:00
.travis.yml Revert "Decomission Travis" 2020-02-04 11:35:19 -06:00
Dockerfile Implement new structure 2020-02-04 14:31:44 -06:00
LICENSE MIT license 2019-02-05 14:56:02 -06:00
README.md Implement new structure 2020-02-04 14:31:44 -06:00
docker-compose.yml Add docker-compose file (#680) 2019-10-29 11:08:01 -05:00
package.json Implement automatic updates 2020-02-14 15:58:39 -06:00
tsconfig.json Implement new structure 2020-02-04 14:31:44 -06:00
yarn.lock Implement automatic updates 2020-02-14 15:58:39 -06:00

README.md

code-server · MIT license "Latest Release" Build Status

code-server is VS Code running on a remote server, accessible through the browser.

Try it out:

docker run -it -p 127.0.0.1:8080:8080 -v "$PWD:/home/coder/project" codercom/code-server
  • Consistent environment: Code on your Chromebook, tablet, and laptop with a 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.
  • 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.

Screenshot

VS Code

  • See our VS Code readme for more information about how code-server and VS Code work together.

Getting Started

Requirements

  • 64-bit host.
  • At least 1GB of RAM.
  • 2 cores or more are recommended (1 core works but not optimally).
  • Secure connection over HTTPS or localhost (required for service workers and clipboard support).
  • For Linux: GLIBC 2.17 or later and GLIBCXX 3.4.15 or later.
  • Docker (for Docker versions of code-server).

Run over SSH

Use sshcode for a simple setup.

Docker

See the Docker one-liner mentioned above. Dockerfile is at /Dockerfile.

Digital Ocean

Create a Droplet

Binaries

  1. Download a binary. (Linux and OS X supported. Windows coming soon)
  2. Unpack the downloaded file then run the binary.
  3. In your browser navigate to localhost:8080.

Build

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.

If changes are made to the patch and you've built previously you must manually reset VS Code then run yarn patch:apply.

Security

Authentication

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.

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 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.

Future

  • Stay up to date! Get notified about new releases of code-server. Screenshot
  • Electron and Chrome OS applications to bridge the gap between local<->remote.

Telemetry

Use the --disable-telemetry flag to completely disable telemetry. We use the data collected to improve code-server.

Contributing

Development

yarn
yarn watch # Visit http://localhost:8080 once completed.

If you run into issues about a different version of Node being used, try running npm rebuild in the VS Code directory.

If changes are made to the patch and you've built previously you must manually reset VS Code then run yarn patch:apply.

License

MIT

Enterprise

Visit our enterprise page for more information about our enterprise offering.

Commercialization

If you would like to commercialize code-server, please contact contact@coder.com.