code-server/docs
Asher b5611efe1a
Use VS Code packaging for releases (#7721)
* Allow setting the VS Code build target

For the NPM package (and tests, at least for now), we will still use
linux-x64, but this is going to allow using the platform build targets
for our standalone releases so we can avoid having to copy all the
packaging steps (like cleaning up modules).

This does mean that the NPM package when installed will be missing those
cleanup steps.  Possibly we can try to break out the packaging step into
a something that can be ran standalone (which will also require
installing dev dependencies like gulp) but not sure how much work this
would be.

* Preserve dependencies for e2e tests

To avoid having to install them again.

Also moved an env block to the root of the  job.

* Refactor releases to use VS Code packaging

Instead of building the linux-x64 package, stripping the modules, then
installing them again, we build the correct target and use the modules
as they are.

This means we do not have to copy all the post-processing steps like the
ones that delete unnecessary modules.

For the NPM package we still publish the linux-x64 package (without
modules of course).  This means npm installations do not get that same
post-processing.

Another advantage of this is that we can run the release immediately
without having to wait for the build step, or on a commit that no longer
has a build artifact, since they all build individually now.  We could
try sharing the core-ci build step, but leaving that alone for now.

I also converted the macOS jobs into a matrix.

Deleted the CI readme because it was out of date and seemed to just
repeat what should be described in the scripts anyway.

Removed a section about Homebrew since we do not maintain that anymore.

It looks like there is no need to symlink node_modules.asar anymore.
2026-03-27 17:08:35 -08:00
..
assets Update screenshots (#6372) 2023-08-07 19:02:54 +00:00
android.md Update Node.js version in Android docs from 18 to 22 (#7542) 2025-10-28 16:14:17 -08:00
CODE_OF_CONDUCT.md refactor: update prettier and doctoc (#5605) 2022-10-13 22:16:55 +00:00
coder.md s/htpps/https (#7662) 2026-02-10 07:33:01 -09:00
collaboration.md release: 4.7.0 (#5546) 2022-09-09 15:15:39 -07:00
CONTRIBUTING.md Use VS Code packaging for releases (#7721) 2026-03-27 17:08:35 -08:00
FAQ.md feat: expose --reconnection-grace-time CLI flag (#7678) 2026-03-25 11:47:58 -08:00
guide.md Release v4.102.0 2025-07-16 18:56:42 -08:00
helm.md release: 4.8.0 (#5698) 2022-10-24 16:23:03 -07:00
install.md chore: bump prettier from 3.4.2 to 3.6.2 (#7407) 2025-08-04 12:46:32 -08:00
ios.md Update ios.md (#5079) 2022-04-12 11:32:49 -07:00
ipad.md refactor: update prettier and doctoc (#5605) 2022-10-13 22:16:55 +00:00
MAINTAINING.md Use VS Code packaging for releases (#7721) 2026-03-27 17:08:35 -08:00
manifest.json Remove deprecated --link (#6018) 2023-02-13 16:52:48 -06:00
npm.md Update Code to 1.101.0 (#7376) 2025-06-16 13:03:47 -08:00
README.md Add Discord link to readme (#7465) 2025-08-25 10:32:11 -08:00
requirements.md Improve README callout to coder/coder (#6579) 2023-12-12 14:23:54 -09:00
SECURITY.md Update Code to 1.94.2 (#7026) 2024-10-17 20:32:21 -08:00
termux.md Update Code to 1.101.0 (#7376) 2025-06-16 13:03:47 -08:00
triage.md docs: Update some more links (#4806) 2022-02-01 09:45:19 -07:00
upgrade.md refactor(docs): clean up and restructure 2021-07-12 14:03:09 -05:00

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.