VS Code in the browser
Go to file
Anmol Sethi c80b2748e1
install.sh: Fixes from @code-asher's review
2020-05-27 15:48:22 -04:00
.github install.sh: Add our own flag parser 2020-05-27 15:48:22 -04:00
ci install.sh: Add our own flag parser 2020-05-27 15:48:22 -04:00
doc install.sh: Add our own flag parser 2020-05-27 15:48:22 -04:00
lib Pin to vscode 1.45.1 2020-05-18 17:34:22 -04:00
src Fix extension install path for CLI 2020-05-27 14:28:40 -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
README.md install.sh: Add our own flag parser 2020-05-27 15:48:22 -04:00
install.sh install.sh: Fixes from @code-asher's review 2020-05-27 15:48:22 -04:00
package.json Release v3.3.1 2020-05-18 18:11:52 -04: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

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.

Install

You can easily and securely install code-server with our install script on any Linux or macOS machine.

# First run to print out the install process.
curl -fsSL https://code-server.dev/install.sh | sh  -s -- --dry-run
# Now it will actually install.
curl -fsSL https://code-server.dev/install.sh | sh
$ curl -fsSL https://code-server.dev/install.sh | sh  -s -- --dry-run --help

Installs latest code-server on any macOS or Linux system preferring to use the OS package manager.

  curl -fsSL https://code-server.dev/install.sh | sh -s --

- For Debian, Ubuntu, Raspbian it will install the latest deb package.
- For Fedora, CentOS, RHEL, openSUSE it will install the latest rpm package.
- For Arch Linux it will install the AUR package.
- For any unrecognized Linux operating system it will install the latest static release into ~/.local
  - Add ~/.local/bin to your $PATH to run code-server.

- For macOS it will install the Homebrew package.
  - If Homebrew is not installed it will install the latest static release into ~/.local
  - Add ~/.local/bin to your $PATH to run code-server.

- If ran on an architecture with no binary releases or outdated libc/libcxx, it will install the
  npm package with yarn or npm.
  - We only have binary releases for amd64 and arm64 presently.

    --dry-run Enables a dry run where where the steps that would have taken place
              are printed but do not actually execute.

    --static  Forces the installation of a static release into ~/.local

              This flag takes an optional argument for the installation prefix which defaults to "~/.local".
              code-server will be unarchived into ~/.local/lib/code-server.X.X.X and the binary will be symlinked
              into "~/.local/bin/code-server". You will need to add ~/.local/bin to your $PATH to use it without
              the full path.

              To install system wide set the prefix to /usr/local.

    --version Pass to install a specific version instead of the latest release.

If you still don't trust our install script, even with the above explaination and the dry run, we have docs in ./doc/install.md that explain how to install code-server on a variety of platforms. The script runs the exact same commands.

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

You should also check out

FAQ

See ./doc/FAQ.md.

Contributing

See ./doc/CONTRIBUTING.md.

Enterprise

Visit our website for more information about our enterprise offerings.