Skip to content
Run VS Code on a remote server.
Branch: master
Clone or download
code-asher Move address output to the listen callback
Since listening is asynchronous, this guarantees the address will be
filled out.
Latest commit 28c9361 Jun 18, 2019


"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 -v "${PWD}:/home/coder/project" codercom/code-server --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.


Getting Started

Run over SSH

Use sshcode for a simple setup.


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


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

How to secure your setup.


Known Issues

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


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


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.


Use the --disable-telemetry flag or set DISABLE_TELEMETRY=true to disable tracking ENTIRELY.

We use data collected to improve code-server.


Development guides are coming soon.




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


If you would like to commercialize code-server, please contact

You can’t perform that action at this time.