Skip to content

/code-server

Run VS Code on a remote server.
  1. TypeScript 58.5%
  2. JavaScript 38.1%
  3. CSS 2.5%
  4. Other 0.9%
Branch: master
Find File
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

@code-asher
code-asher Ensure all environment paths are created 
This normally happens in electron-main/main.ts but we don't run anything
from there.

Fixes #499.
Latest commit b8f222a Apr 16, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update codeowners Mar 19, 2019
build
deployment Add support for Kubernetes by deploying code-server. Also includes AWS ( Mar 18, 2019
doc Fix typo: doc/self-hosted/index.md (#477) Apr 12, 2019
packages Ensure all environment paths are created Apr 16, 2019
rules
scripts Ensure all environment paths are created Apr 16, 2019
.dockerignore Update node to 10.15.1 (#472) Apr 16, 2019
.gitignore Feature/relative url (#307) Apr 11, 2019
.node-version Update node to 10.15.1 (#472) Apr 16, 2019
.travis.yml
Dockerfile
LICENSE MIT license Feb 5, 2019
README.md Remove hosted from the readme Apr 11, 2019
package.json
tsconfig.json Update node to 10.15.1 (#472) Apr 16, 2019
tslint.json Remove URI factory Feb 6, 2019
yarn.lock

README.md

code-server

"Open Issues" "Latest Release" MIT license Discord

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:8443:8443 -v "${PWD}:/home/coder/project" codercom/code-server:1.621 --allow-http --no-auth
  • Code on your Chromebook, tablet, and laptop with a consistent dev environment.
    • If you have a Windows or Mac workstation, more easily develop for Linux.
  • Take advantage of large cloud servers to speed up tests, compilations, downloads, and more.
  • Preserve battery life when you're on the go.
    • All intensive computation runs on your server.
    • You're no longer running excess instances of Chrome.

Screenshot

Getting Started

Docker

See docker oneliner mentioned above. Dockerfile is at /Dockerfile.

Binaries

  1. Download a binary (Linux and OS X supported. Windows coming soon)

  2. Start the binary with the project directory as the first argument

    code-server <initial directory to open>

    You will be prompted to enter the password shown in the CLI code-server should now be running at https://localhost:8443.

    code-server uses a self-signed SSL certificate that may prompt your browser to ask you some additional questions before you proceed. Please read here for more information.

For detailed instructions and troubleshooting, see the self-hosted quick start guide.

Quickstart guides for Google Cloud, AWS, and Digital Ocean.

How to secure your setup.

Development

Known Issues

  • Creating custom VS Code extensions and debugging them doesn't work.

Future

  • Stay up to date! Get notified about new releases of code-server. Screenshot
  • Windows support.
  • Electron and Chrome OS applications to bridge the gap between local<->remote.
  • Run VS Code unit tests against our builds to ensure features work as expected.

Extensions

At the moment we can't use the official VSCode Marketplace. We've created a custom extension marketplace focused around open-sourced extensions. However, if you have access to the .vsix file, you can manually install the extension.

Contributing

Development guides are coming soon.

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.

You can’t perform that action at this time.