No Description

Anmol Sethi 3140a0cb15 Merge pull request #1719 from cucumberbob123/patch-1 2 days ago
.github 3445a55c2b Add issue template for extension request 6 days ago
ci 521ac7d91f Merge pull request #1697 from cdr/aur-docs 1 week ago
doc 9a8c06d09d Fixed grammar error 3 days ago
lib ce9d14d55e Pin to vscode 1.45.1 1 week ago
src 8053ec6872 Allow user-data-dir and extension-dir in config.yaml 1 week ago
test 8053ec6872 Allow user-data-dir and extension-dir in config.yaml 1 week ago
typings 4aa15401c3 Format and lint 3 months ago
.dockerignore 6282cd7e7b Simplify packaging and improve scripts 2 weeks ago
.editorconfig b9e7a3daa7 Add back .editorconfig 3 months ago
.eslintrc.yaml c0d6eb4664 Improve password handling 2 weeks ago
.gitignore e4ddffd0e2 Workaround for GH Actions stripping permissions 1 week ago
.gitmodules b29346ecdf Implement new structure 3 months ago
.prettierrc.yaml 80b1b1b672 Shake CI and docs up 3 months ago
.stylelintrc.yaml 5681c87e33 Fix bugs in CI 3 months ago
LICENSE.txt 80b1b1b672 Shake CI and docs up 3 months ago
README.md 0d207f4f9a Update AUR docs 1 week ago
package.json 5f94d5a687 Release v3.3.1 1 week ago
tsconfig.json 4aa15401c3 Format and lint 3 months ago
yarn.lock a0a77e379e Add doc/guide.md 1 week ago

README.md

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 Linux

# Installs code-server from the AUR using yay.
yay -S code-server
systemctl --user enable --now code-server
# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
# Installs code-server from the AUR with plain makepkg.
git clone https://aur.archlinux.org/code-server.git
cd code-server
makepkg -si
systemctl --user enable --now code-server
# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml

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.