76e0338d7f
Cannot mount data directory at the moment, we need to make code-server override all binaries in there instead of reusing and will wait until the new Dockerfile is pushed before removing the default entrypoint from README.md
80 lines
2.8 KiB
Markdown
80 lines
2.8 KiB
Markdown
# code-server
|
|
|
|
[](https://github.com/codercom/code-server/issues)
|
|
[](https://github.com/codercom/code-server/releases/latest)
|
|
[](#)
|
|
[](https://discord.gg/zxSwN8Z)
|
|
|
|
`code-server` is [VS Code](https://github.com/Microsoft/vscode) running on a remote server, accessible through the browser.
|
|
|
|
Try it out:
|
|
```bash
|
|
docker run -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.
|
|
|
|
|
|
|
|
## Getting Started
|
|
|
|
### Hosted
|
|
|
|
[Try `code-server` now](https://coder.com/signup) for free at coder.com.
|
|
|
|
### Docker
|
|
|
|
See docker oneliner mentioned above. Dockerfile is at [/Dockerfile](/Dockerfile).
|
|
|
|
### Binaries
|
|
|
|
1. [Download a binary](https://github.com/codercom/code-server/releases) (Linux and OSX 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 [Digital Ocean](doc/admin/install/digitalocean.md).
|
|
|
|
How to [secure your setup](/doc/security/ssl.md).
|
|
|
|
## Development
|
|
|
|
### Known Issues
|
|
|
|
- Creating custom VS Code extensions and debugging them doesn't work.
|
|
|
|
### Future
|
|
|
|
- Windows support.
|
|
- Electron and ChromeOS applications to bridge the gap between local<->remote.
|
|
- Run VS Code unit tests against our builds to ensure features work as expected.
|
|
|
|
## Contributing
|
|
|
|
Development guides are coming soon.
|
|
|
|
## License
|
|
|
|
[MIT](LICENSE)
|
|
|
|
## Enterprise
|
|
|
|
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.
|