code-server/README.md

133 lines
4.7 KiB
Markdown
Raw Normal View History

# code-server
2019-01-08 00:46:19 +00:00
2019-04-27 20:57:10 +00:00
[!["Open Issues"](https://img.shields.io/github/issues-raw/cdr/code-server.svg)](https://github.com/cdr/code-server/issues)
[!["Latest Release"](https://img.shields.io/github/release/cdr/code-server.svg)](https://github.com/cdr/code-server/releases/latest)
[![MIT license](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/cdr/code-server/blob/master/LICENSE)
[![Discord](https://img.shields.io/discord/463752820026376202.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/zxSwN8Z)
2019-01-08 00:46:19 +00:00
`code-server` is [VS Code](https://github.com/Microsoft/vscode) running on a
remote server, accessible through the browser.
2019-03-06 01:45:21 +00:00
2019-03-07 02:59:43 +00:00
Try it out:
```bash
2019-05-02 17:32:05 +00:00
docker run -it -p 127.0.0.1:8443:8443 -v "${PWD}:/home/coder/project" codercom/code-server --allow-http --no-auth
2019-03-07 02:59:43 +00:00
```
2019-03-06 01:45:21 +00:00
- 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.
2019-03-06 01:45:21 +00:00
- 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](/doc/assets/ide.png)
## Getting Started
2019-04-20 01:20:31 +00:00
### Run over SSH
2019-04-20 01:22:00 +00:00
Use [sshcode](https://github.com/codercom/sshcode) for a simple setup.
2019-04-20 01:20:31 +00:00
2019-03-07 02:59:43 +00:00
### Docker
See docker oneliner mentioned above. Dockerfile is at
[/Dockerfile](/Dockerfile).
2019-03-07 02:59:43 +00:00
### Binaries
1. [Download a binary](https://github.com/cdr/code-server/releases) (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](doc/self-hosted/index.md) for more information.
For detailed instructions and troubleshooting, see the
[self-hosted quick start guide](doc/self-hosted/index.md).
Quickstart guides for [Google Cloud](doc/admin/install/google_cloud.md),
[AWS](doc/admin/install/aws.md), and
[DigitalOcean](doc/admin/install/digitalocean.md).
2019-01-08 00:46:19 +00:00
How to [secure your setup](/doc/security/ssl.md).
### Build
2019-07-03 00:10:17 +00:00
- 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.
2019-07-08 15:33:58 +00:00
- For now `@coder/nbin` is a global dependency.
2019-07-10 23:10:39 +00:00
- 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.
2019-07-02 16:33:27 +00:00
### Development
2019-07-10 21:29:15 +00:00
```fish
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").
2019-07-12 20:21:00 +00:00
yarn start --allow-http --no-auth
2019-07-10 21:29:15 +00:00
# Visit http://localhost:8443
```
2019-06-27 22:34:33 +00:00
## Known Issues
- Creating custom VS Code extensions and debugging them doesn't work.
- To debug Golang using
[ms-vscode-go extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode.Go),
you need to add `--security-opt seccomp=unconfined` to your `docker run`
arguments when launching code-server with Docker. See
[#725](https://github.com/cdr/code-server/issues/725) for details.
## Future
- **Stay up to date!** Get notified about new releases of code-server.
![Screenshot](/doc/assets/release.gif)
- Windows support.
2019-03-14 22:32:18 +00:00
- 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
Set the `telemetry.enableTelemetry` user setting to false to disable telemetry.
We use data collected to improve code-server.
## Contributing
2019-01-08 00:46:19 +00:00
2019-03-06 18:11:27 +00:00
Development guides are coming soon.
2019-01-08 00:46:19 +00:00
## License
2019-01-08 00:46:19 +00:00
[MIT](LICENSE)
2019-01-08 00:46:19 +00:00
## Enterprise
2019-01-08 00:46:19 +00:00
Visit [our enterprise page](https://coder.com/enterprise) for more information
about our enterprise offering.
## Commercialization
If you would like to commercialize code-server, please contact
contact@coder.com.