Go to file
Anmol Sethi 08f5760718
Merge pull request #1703 from cdr/auto-update
Make automatic updates on v3.2.0 work again
2020-05-20 11:45:24 -04:00
.github Clarify language in issue template 2020-05-19 22:47:34 -04:00
ci Make automatic updates on v3.2.0 work again 2020-05-20 10:37:31 -04:00
doc Improve clarity in guide and fix typo in FAQ 2020-05-19 13:46:19 -04:00
lib Pin to vscode 1.45.1 2020-05-18 17:34:22 -04:00
src Allow user-data-dir and extension-dir in config.yaml 2020-05-19 00:41:27 -04:00
test Allow user-data-dir and extension-dir in config.yaml 2020-05-19 00:41:27 -04:00
typings/httpolyglot Format and lint 2020-02-14 20:00:19 -05:00
.dockerignore Simplify packaging and improve scripts 2020-05-08 01:04:24 -04:00
.editorconfig Add back .editorconfig 2020-02-19 14:22:14 -05:00
.eslintrc.yaml Improve password handling 2020-05-12 19:59:55 -04:00
.gitignore Workaround for GH Actions stripping permissions 2020-05-18 13:56:53 -04:00
.gitmodules Implement new structure 2020-02-04 14:31:44 -06:00
.prettierrc.yaml Shake CI and docs up 2020-02-14 19:46:17 -05:00
.stylelintrc.yaml Fix bugs in CI 2020-02-18 19:06:35 -05:00
LICENSE.txt Shake CI and docs up 2020-02-14 19:46:17 -05:00
package.json Release v3.3.1 2020-05-18 18:11:52 -04:00
README.md Document AUR install instructions 2020-05-19 22:41:28 -05:00
tsconfig.json Format and lint 2020-02-14 20:00:19 -05:00
yarn.lock Add doc/guide.md 2020-05-14 05:24:23 -04:00

code-server

Run VS Code on any machine anywhere and access it in the browser.

  • Code everywhere: 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

Getting Started

For a full setup and walkthrough, please see ./doc/guide.md.

Debian, Ubuntu

curl -sSOL https://github.com/cdr/code-server/releases/download/v3.3.1/code-server_3.3.1_amd64.deb
sudo dpkg -i code-server_3.3.1_amd64.deb
systemctl --user enable --now code-server
# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml

Fedora, Red Hat, SUSE

curl -sSOL https://github.com/cdr/code-server/releases/download/v3.3.1/code-server-3.3.1-amd64.rpm
sudo yum install -y code-server-3.3.1-amd64.rpm
systemctl --user enable --now code-server
# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml

Arch

We publish code-server releases to the our AUR package. Use your favorite AUR helper to install. Ours is yay.

yay -S code-server

Alternatively, build the package yourself from the Github repo.

git clone https://github.com/cdr/code-server-aur
cd code-server-aur
makepkg -si

yarn, npm

We recommend installing with yarn or npm if we don't have a precompiled release for your machine's platform or architecture or your glibc < v2.19.

note: Installing via yarn or npm builds native modules on install and so requires C dependencies. See ./doc/npm.md for installing these dependencies.

You will need at least node v12 installed. See #1633.

yarn global add code-server
# Or: npm install -g code-server
code-server
# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml

macOS

brew install code-server
brew services start code-server
# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml

Docker

# 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.
docker run -it -p 127.0.0.1:8080:8080 \
  -v "$PWD:/home/coder/project" \
  -u "$(id -u):$(id -g)" \
  codercom/code-server:latest

Static Releases

We publish self contained .tar.gz archives for every release on github. They bundle the node binary and node_modules.

  1. Download the latest release archive for your system from github.
  2. Unpack the release.
  3. You can run code-server by executing ./bin/code-server.

Add the code-server bin directory to your $PATH to easily execute code-server without the full path every time.

Here is an example script for installing and using a static code-server release on Linux:

curl -sSL https://github.com/cdr/code-server/releases/download/v3.3.1/code-server-3.3.1-linux-amd64.tar.gz \
  | sudo tar -C /usr/local -xz
sudo mv /usr/local/code-server-3.3.1-linux-amd64 /usr/local/code-server-3.3.1
PATH="/usr/local/code-server-3.3.1/bin:$PATH"
code-server
# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml

FAQ

See ./doc/FAQ.md.

Contributing

See ./doc/CONTRIBUTING.md.

Enterprise

Visit our website for more information about our enterprise offerings.