Archived
1
0
VS Code in the browser
This repository has been archived on 2024-09-09. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Asher 81862d4fa1
Add back (most of) our old arguments
Also remove VS Code ones that don't work.
2019-07-18 18:08:38 -05:00
.github Update codeowners 2019-03-19 14:00:25 -04:00
deployment Rename codercom/code-server to cdr/code-server 2019-05-02 11:25:50 -04:00
doc Merge branch 'log-failed-logins' of github.com:cdr/code-server into log-failed-logins 2019-07-11 12:31:52 +10:00
scripts Add back (most of) our old arguments 2019-07-18 18:08:38 -05:00
.dockerignore Update node to 10.15.1 (#472) 2019-04-15 19:48:12 -05:00
.gitignore Add build scripts 2019-07-18 18:08:27 -05:00
.node-version Update node to 10.15.1 (#472) 2019-04-15 19:48:12 -05:00
.travis.yml Make extension sidebar work 2019-07-18 18:08:36 -05:00
channel.ts Implement extensions channel 2019-07-18 18:08:32 -05:00
cli.ts Add back (most of) our old arguments 2019-07-18 18:08:38 -05:00
connection.ts Use new URI transformer everywhere 2019-07-18 18:08:18 -05:00
Dockerfile Remove chmod on project dir 2019-04-17 18:36:33 -04:00
insights.ts Delete all the things 2019-07-18 18:08:11 -05:00
LICENSE MIT license 2019-02-05 14:56:02 -06:00
main.js Use nbin in forked processes 2019-07-18 18:08:30 -05:00
package.json Make extension sidebar work 2019-07-18 18:08:36 -05:00
protocol.ts Prevent sending disconnect if disposed 2019-07-18 18:08:21 -05:00
README.md Include version when building 2019-07-18 18:08:37 -05:00
server.ts Create extension directory on startup 2019-07-18 18:08:37 -05:00
tar.ts Add cli arguments 2019-07-18 18:08:25 -05:00
tslint.json Initial connection handling 2019-07-18 18:08:13 -05:00
upload.ts Delete all the things 2019-07-18 18:08:11 -05:00
uriTransformer.js Make extension sidebar work 2019-07-18 18:08:36 -05:00
uriTransformerHttps.js Make extension sidebar work 2019-07-18 18:08:36 -05:00
yarn.lock Add build scripts 2019-07-18 18:08:27 -05:00

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

Run over SSH

Use sshcode for a simple setup.

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

How to secure your setup.

Build

  • If you also plan on developing, set the OUT environment variable: export OUT=/path/to/some/directory. Otherwise it will build in this directory which will cause issues because then yarn watch will try to compile the build directory as well.
  • For now @coder/nbin is a global dependency.
  • Run yarn build ${codeServerVersion} ${vscodeVersion} ${target} ${arch} in this directory (for example: yarn build development 1.35.0 linux x64).
  • You can run the built code with node path/to/build/out/vs/server/main.js or run yarn binary with the same arguments in the previous step to package the code into a single binary.

Development

git clone https://github.com/microsoft/vscode
cd vscode
git clone https://github.com/cdr/code-server src/vs/server
cd src/vs/server
yarn patch:apply
yarn
yarn watch
# Wait for the initial compilation to complete (it will say "Finished compilation").
yarn start
# Visit http://localhost:8443

Known Issues

  • Creating custom VS Code extensions and debugging them doesn't work.
  • To debug Golang using ms-vscode-go extension, you need to add --security-opt seccomp=unconfined to your docker run arguments when launching code-server with Docker. See #725 for details.

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.

Telemetry

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

We use data collected to improve code-server.

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.