code-server/README.md

55 lines
1.6 KiB
Markdown
Raw Normal View History

2020-02-19 00:07:01 +00:00
# code-server
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:
2019-09-27 14:39:29 +00:00
2019-03-07 02:59:43 +00:00
```bash
docker run -it -p 127.0.0.1:8080:8080 -v "$PWD:/home/coder/project" codercom/code-server
2019-03-07 02:59:43 +00:00
```
- **Code anywhere:** Code on your Chromebook, tablet, and laptop with a
consistent dev environment. Develop on a Linux machine and pick up from any
device with a web browser.
2019-07-31 22:08:37 +00:00
- **Server-powered:** Take advantage of large cloud servers to speed up tests,
compilations, downloads, and more. Preserve battery life when you're on the go
since all intensive computation runs on your server.
2020-03-02 21:13:39 +00:00
![Example gif](/doc/assets/code-server.gif)
## Getting Started
### Requirements
2019-10-30 15:33:07 +00:00
- 64-bit host.
- At least 1GB of RAM.
- 2 cores or more are recommended (1 core works but not optimally).
2020-02-04 19:27:46 +00:00
- Secure connection over HTTPS or localhost (required for service workers and
clipboard support).
2019-10-30 15:33:07 +00:00
- For Linux: GLIBC 2.17 or later and GLIBCXX 3.4.15 or later.
2019-04-20 01:20:31 +00:00
### Run over SSH
2019-09-27 14:39:29 +00:00
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-09-13 15:17:27 +00:00
### Digital Ocean
2019-09-27 14:39:29 +00:00
2019-09-13 15:17:27 +00:00
[![Create a Droplet](./doc/assets/droplet.svg)](https://marketplace.digitalocean.com/apps/code-server?action=deploy)
### Releases
2019-09-27 14:39:29 +00:00
1. [Download a release](https://github.com/cdr/code-server/releases). (Linux and
OS X supported. Windows support planned.)
2. Unpack the downloaded release then run the included `code-server` script.
2019-08-08 16:21:45 +00:00
3. In your browser navigate to `localhost:8080`.
2019-01-08 00:46:19 +00:00
2020-02-19 00:07:01 +00:00
## FAQ
2020-02-19 00:07:01 +00:00
See [./doc/FAQ.md](./doc/FAQ.md).
2019-01-08 00:46:19 +00:00
## Enterprise
2019-09-27 14:39:29 +00:00
2019-11-14 17:16:08 +00:00
Visit [our enterprise page](https://coder.com) for more information about our
2020-02-19 00:07:01 +00:00
enterprise offerings.