Skip to content
Run VS Code on a remote server.
Branch: master
Clone or download
code-asher Fix port scanner when netstat isn't available
- It logs the error now.
- For some reason when there is an error node-netstat runs the callback
  twice. That resulted in us scheduling an exponentially growing number
	of calls which ate up all the CPU (and probably memory eventually).
  For now, opted to dispose when there is an error.
Latest commit d16c6ae Mar 25, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update codeowners Mar 19, 2019
build Another fix for the Dockerfile and build (#188) Mar 11, 2019
deployment
doc Update index.md (#297) Mar 21, 2019
packages Fix port scanner when netstat isn't available Mar 25, 2019
rules Remove block padding (blank lines) Feb 6, 2019
scripts Fix failure to resolve arrays error Mar 19, 2019
.dockerignore Improve .dockerignore (#111) Mar 8, 2019
.gitignore Add task for packaging release (#6) Mar 7, 2019
.travis.yml ci: enable travis npm cache (#110) Mar 8, 2019
Dockerfile Dockerfile: include git Mar 13, 2019
LICENSE MIT license Feb 5, 2019
README.md Add note about extensions needing to be OSS (#113) Mar 22, 2019
package.json Fix trash Mar 12, 2019
tsconfig.json Featureful (#31) Feb 21, 2019
tslint.json Remove URI factory Feb 6, 2019
yarn.lock Fix trash Mar 12, 2019

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 -t -p 127.0.0.1:8443:8443 -v "${PWD}:/root/project" codercom/code-server 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.

Screenshot

Getting Started

Hosted

Try code-server now for free at coder.com.

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

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

Notes

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