2020-02-19 07:07:01 +07:00
|
|
|
# code-server
|
2019-01-08 07:46:19 +07:00
|
|
|
|
2020-05-12 12:46:38 +07:00
|
|
|
Run [VS Code](https://github.com/Microsoft/vscode) on any machine anywhere and access it through the browser.
|
2019-03-06 08:45:21 +07:00
|
|
|
|
2020-05-12 12:46:38 +07: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.
|
|
|
|
- **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 tasks runs on your server.
|
|
|
|
Make use of a spare computer you have lying around and turn it into a full development environment.
|
|
|
|
|
|
|
|
![Example gif](./doc/assets/code-server.gif)
|
|
|
|
|
|
|
|
## Getting started
|
|
|
|
|
|
|
|
For a proper setup and walkthrough, please see [./doc/guide.md](./doc/guide.md).
|
|
|
|
|
|
|
|
### Debian, Ubuntu
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2019-03-07 09:59:43 +07:00
|
|
|
```bash
|
2020-05-12 12:46:38 +07:00
|
|
|
curl -sSOL https://github.com/cdr/code-server/releases/download/3.3.0/code-server_3.3.0_amd64.deb
|
|
|
|
sudo dpkg -i code-server_3.3.0_amd64.deb
|
|
|
|
sudo systemctl enable --now code-server
|
|
|
|
# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
|
2019-03-07 09:59:43 +07:00
|
|
|
```
|
|
|
|
|
2020-05-12 12:46:38 +07:00
|
|
|
### Fedora, Red Hat, SUSE
|
2019-03-05 01:31:27 +07:00
|
|
|
|
2020-05-12 12:46:38 +07:00
|
|
|
```bash
|
|
|
|
curl -sSOL https://github.com/cdr/code-server/releases/download/3.3.0/code-server-3.3.0-amd64.rpm
|
2020-05-13 10:11:31 +07:00
|
|
|
sudo yum install -y code-server-3.3.0-amd64.rpm
|
2020-05-12 12:46:38 +07:00
|
|
|
sudo systemctl enable --now code-server
|
|
|
|
# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
|
|
|
|
```
|
2020-03-03 04:13:39 +07:00
|
|
|
|
2020-05-12 12:46:38 +07:00
|
|
|
### npm
|
2019-09-19 01:21:38 +07:00
|
|
|
|
2020-05-13 10:11:31 +07:00
|
|
|
**note:** Installing via `npm` requires building native module dependencies. See [./doc/npm.md](./doc/npm.md)
|
|
|
|
for the dependency install process depending on your OS.
|
|
|
|
|
2020-05-12 12:46:38 +07:00
|
|
|
```bash
|
|
|
|
npm install -g code-server
|
|
|
|
code-server
|
2020-05-13 06:33:34 +07:00
|
|
|
# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
|
2020-05-12 12:46:38 +07:00
|
|
|
```
|
2019-09-19 01:21:38 +07:00
|
|
|
|
2020-05-12 12:46:38 +07:00
|
|
|
### macOS
|
2019-09-19 01:21:38 +07:00
|
|
|
|
2020-05-12 12:46:38 +07:00
|
|
|
```bash
|
|
|
|
brew install code-server
|
|
|
|
brew service start code-server
|
|
|
|
# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
|
|
|
|
```
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2020-05-12 12:46:38 +07:00
|
|
|
### Docker
|
|
|
|
|
|
|
|
```bash
|
|
|
|
docker run -it -p 127.0.0.1:8080:8080 -v "$PWD:/home/coder/project" -u "$(id -u):$(id -g)" codercom/code-server:latest
|
|
|
|
```
|
|
|
|
|
|
|
|
This will start a code-server container and expose it at http://127.0.0.1:8080. It will also mount
|
|
|
|
your current directory into the container as `/home/coder/project` and forward your UID/GID so that
|
|
|
|
all file system operations occur as your user outside the container.
|
|
|
|
|
|
|
|
### Self contained releases
|
|
|
|
|
|
|
|
We publish self contained archives for every release on [github](https://github.com/cdr/code-server/releases).
|
|
|
|
They bundle the node binary and node_modules.
|
|
|
|
|
|
|
|
1. Download the latest release archive for your system from [github](https://github.com/cdr/code-server/releases)
|
|
|
|
2. Unpack the release
|
|
|
|
3. You can run code-server by executing `bin/code-server`
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2020-05-12 12:46:38 +07:00
|
|
|
Add the code-server `bin` directory to your `$PATH` to easily execute it without the full path every time.
|
|
|
|
|
|
|
|
Here is an example script for installing and using a self-contained code-server release on Linux:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
curl -sSL https://github.com/cdr/code-server/releases/download/3.3.0/code-server-3.3.0-linux-amd64.tar.gz | sudo tar -C /opt -xz
|
|
|
|
PATH="$PATH:/opt/code-server-3.3.0-linux-amd64/bin"
|
|
|
|
code-server
|
|
|
|
```
|
2019-01-08 07:46:19 +07:00
|
|
|
|
2020-02-19 07:07:01 +07:00
|
|
|
## FAQ
|
2019-10-23 23:49:05 +07:00
|
|
|
|
2020-02-19 07:07:01 +07:00
|
|
|
See [./doc/FAQ.md](./doc/FAQ.md).
|
2019-01-08 07:46:19 +07:00
|
|
|
|
2020-03-20 04:53:31 +07:00
|
|
|
## Contributing
|
|
|
|
|
|
|
|
See [./doc/CONTRIBUTING.md](./doc/CONTRIBUTING.md).
|
|
|
|
|
2019-03-05 01:31:27 +07:00
|
|
|
## Enterprise
|
2019-09-27 21:39:29 +07:00
|
|
|
|
2019-11-15 00:16:08 +07:00
|
|
|
Visit [our enterprise page](https://coder.com) for more information about our
|
2020-02-19 07:07:01 +07:00
|
|
|
enterprise offerings.
|