33717b277a
* Add docs * Add guides for hosting * Inital commit. Add quick start guide for self hosted * Add info for flags * Detail usage flags and provide examples * Correct file types for certificate * Add self-signed certificate guide, update .gitignore * Add additional information.: * Checkout to master * Add transition document, add some links to readme * Comment out some stuff * Revise transition document * Fix typo * Add Google Cloud setup guide * fix link * Add guide links to readme * Add AWS deployment guide * Fixup based on PR suggestions * Fixup ssl guide and readme * Fix typo * Add step to make binary executable * Add digitalocean guide, update readme, add chmod steps just in case * add information about securing the connection to each deploy guide * Update doc/security/ssl.md Co-Authored-By: nol166 <jmccamb@gmail.com> * Fixup from PR suggestions * Add guide for systemd for when ssh closes * Fix typos * VS Code Remote -> code-server * Fix minor stylistics * Update readme (#43) * Update readme * Add details about chrome warning * Add back extension ID settings * Add back SSL guide to readme * State that chmod is likely not necessary * Fix type * Update readme * Remove transition guide * Revise readme based on suggestions. (#45) * Update references to vscode-remote * No Windows support yet
54 lines
1.9 KiB
Markdown
54 lines
1.9 KiB
Markdown
# code-server
|
||
|
||
[](https://github.com/codercom/code-server/issues)
|
||
[](https://github.com/codercom/code-server/releases/latest)
|
||
[](#)
|
||
|
||
`code-server` is VS Code running on a remote server, accessible through the browser.
|
||
|
||
|
||
|
||
## Getting Started
|
||
|
||
[Try `code-server` now](https://coder.com/signup) for free at coder.com.
|
||
|
||
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 <inital directory to open>
|
||
```
|
||
> You will be prompted to enter the password shown in the CLI
|
||
`code-server` should now be running at https://<IP>: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
|
||
|
||
- Debugging extensions 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
|
||
|
||
Guides on setup for development will be coming soon. :)
|
||
|
||
## License
|
||
|
||
[MIT](LICENSE)
|
||
|
||
## Enterprise
|
||
|
||
Visit [our enterprise page](https://coder.com/enterprise) for more information on our enterprise offering.
|