Add documentation (#42)

* 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
This commit is contained in:
Kyle Carberry
2019-03-04 10:31:27 -08:00
committed by Asher
parent 90d3a0f16a
commit 33717b277a
19 changed files with 380 additions and 17 deletions

View File

@ -1,24 +1,53 @@
# vscode-remote
# code-server
Run VS Code remotely.
[!["Open Issues"](https://img.shields.io/github/issues-raw/codercom/code-server.svg)](https://github.com/codercom/code-server/issues)
[!["Latest Release"](https://img.shields.io/github/release/codercom/code-server.svg)](https://github.com/codercom/code-server/releases/latest)
[![MIT license](https://img.shields.io/badge/license-MIT-green.svg)](#)
`code-server` is VS Code running on a remote server, accessible through the browser.
![Screenshot](/doc/assets/ide.png)
## 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 doesnt 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
### Getting the source
Guides on setup for development will be coming soon. :)
```
git clone https://github.com/codercom/vscode-remote
```
## License
### Installing dependencies
[MIT](LICENSE)
```
cd vscode-remote
yarn
```
## Enterprise
### Run
```
yarn start
```
Visit [our enterprise page](https://coder.com/enterprise) for more information on our enterprise offering.