code-server is a free, open source ides & code editors project written in TypeScript and released under MIT. It has 79,352 GitHub stars, 6,856 forks and 152 open issues, and was last pushed 26 hours ago. On this registry it ranks #4 of 12 tracked projects in IDEs & Code Editors, with 5 head-to-head comparisons available.

What is code-server?

code-server is an MIT-licensed TypeScript project from Coder that runs VS Code on a remote machine and serves the full editor in a browser, aimed at developers who want one consistent development environment reachable from any device.

What it is

code-server is a browser-based distribution of VS Code. It takes the editor and runs it on a remote host — a cloud server, a home lab box, a workstation — and exposes it over the network so the interface loads in a browser tab. The project lives in the Coder ecosystem alongside coder/coder, the separate product the same company builds for teams adopting remote development, and it carries the topics browser-ide, dev-tools, development-environment, ide, remote-work, vscode, and vscode-remote.

The concrete problem it solves is environment drift and machine dependence. Instead of installing and syncing an editor across a laptop, a desktop, and a borrowed machine, a developer points a browser at one server that holds the code, the toolchain, and the running processes. It replaces the local installation of VS Code for people who want the editor to follow the server rather than the device. Intensive work — tests, compilations, downloads — runs on that server, which keeps the client machine's battery and CPU out of the loop.

Key capabilities

  • Runs VS Code in a browser so the editor is reachable from any device with a network connection to the host.
  • Ships an install script, install.sh, invoked as curl -fsSL https://code-server.dev/install.sh | sh, which automates setup and uses the system package manager where possible.
  • Supports a dry run of that script with curl -fsSL https://code-server.dev/install.sh | sh -s -- --dry-run, so the install steps can be previewed before anything changes.
  • Offers one-click buttons and guides for deploying to a cloud provider through the coder/deploy-code-server repository.
  • Provides a code-server feature for devcontainers, for projects that already use devcontainers in their workflow.
  • Can be deployed to a team through coder/coder when code-server needs to be managed across multiple developers and machines.
  • Supports manual installation as a distinct path from the install script, for hosts where the automated route does not fit.

Who uses it and how

  • Individual developers who keep a cloud server as the place where code, dependencies, and builds live, and connect to it from whatever machine is at hand.
  • Developers on the move who want heavy tasks to execute on a server so the local device's battery life is preserved.
  • Teams that run a shared remote development setup, using coder/coder to manage code-server across their infrastructure rather than installing it per person.
  • Projects already using devcontainers, which can add the code-server feature instead of changing their environment definition.
  • Self-hosters deploying to a cloud provider through the one-click guides, on a host that meets the stated minimum of a Linux machine with WebSockets enabled, 1 GB RAM, and 2 vCPUs.

Getting started

The documented path is the install script: curl -fsSL https://code-server.dev/install.sh | sh, which prints instructions for running and starting code-server when it finishes. Alternatives are manual installation, deployment with coder/coder, one-click cloud provider guides, and the devcontainer feature.

How it compares

code-server is not positioned against a paid competitor in these facts; it sits next to coder/coder, the companion product for teams that need remote development managed across an organisation, rather than as a replacement for it. It also relates to VS Code itself, whose editor it serves in the browser, and to devcontainers, where it exists as an addable feature rather than a competing environment format.

When to use it — and when not to

A self-hoster must supply a Linux host with WebSockets enabled and at least 1 GB RAM and 2 vCPUs, and must handle the network exposure of an editor reachable over the browser. Anyone wanting managed multi-developer provisioning should look at coder/coder instead, since code-server alone is the per-machine component. The README itself is sparse — requirements, installation detail, configuration, and the FAQ all live on external documentation pages — so expect to read beyond the repository to run it well.

project readme (upstream, from github) — read inline

code-server

"GitHub Discussions" "Join us on Slack" Twitter Follow Discord codecov See latest

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

Screenshot Screenshot

Highlights

  • Code on any device with a consistent development environment
  • Use cloud servers to speed up tests, compilations, downloads, and more
  • Preserve battery life when you're on the go; all intensive tasks run on your server

Requirements

See requirements for minimum specs, as well as instructions on how to set up a Google VM on which you can install code-server.

TL;DR: Linux machine with WebSockets enabled, 1 GB RAM, and 2 vCPUs

Getting started

There are five ways to get started:

  1. Using the install script, which automates most of the process. The script uses the system package manager if possible.
  2. Manually installing code-server
  3. Deploy code-server to your team with coder/coder
  4. Using our one-click buttons and guides to deploy code-server to a cloud provider
  5. Using the code-server feature for devcontainers, if you already use devcontainers in your project.

If you use the install script, you can preview what occurs during the install process:

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

To install, run:

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

When done, the install script prints out instructions for running and starting code-server.

Note To manage code-server for a team on your infrastructure, see: coder/coder

We also have an in-depth setup and configuration guide.

Questions?

See answers to frequently asked questions.

Want to help?

See Contributing for details.

Hiring

Interested in working at Coder? Check out our open positions!

For Teams

We develop coder/coder to help teams to adopt remote development.

Frequently asked questions

Is code-server free to use?

code-server is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does code-server do?

VS Code in the browser

What is code-server written in?

code-server is primarily written in TypeScript. Its source is publicly available at https://github.com/coder/code-server, and it has 79,352 GitHub stars.