selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
Visual Studio Code Server logo

Self-host Visual Studio Code Server

4.145.2-ls376

VS Code in the browser, packaged as a Docker image

ReleaseOpen SourceGPL-3.0
Updated23 hours ago
LanguageDockerfile
Setup difficultyEasy
MobilePWA
Stars
2 010
Port
8443 (Web gui)
Docker
lscr.io/linuxserver/code-server
Install with Docker

What is Visual Studio Code Server?

linuxserver/code-server is a LinuxServer.io container image that packages code-server, the browser build of VS Code, so a developer can edit code on their own server from any machine. The web UI is reached on port 8443, config lives in a single /config bind mount, and an optional PASSWORD or HASHED_PASSWORD guards the interface while sudo access in the built-in terminal can be enabled with SUDO_PASSWORD or SUDO_PASSWORD_HASH. The image also supports subdomain proxying via PROXY_DOMAIN, a DEFAULT_WORKSPACE folder, a renameable PWA, read-only and non-root container operation, GitHub use by dropping an SSH key into /config/.ssh, and LinuxServer Docker Mods for extra functionality. Multi-arch manifests cover x86-64 and arm64; you start it with docker compose or docker run, and updates come by pulling a new image tag (release tags track upstream code-server versions, e.g. 4.141.0-ls371).

Visual Studio Code Server alternatives

Should you self-host Visual Studio Code Server?

Visual Studio Code Server scores 61/100 on selfhost.directory (how scoring works) and ranks #42 of 167 in Developer Tools. It has 2 010 GitHub stars, +15 in the last 30 days.

It shipped 41 stable releases in the past year. The latest, 4.145.2-ls376, came out on 7 November 2026. New versions land roughly every 5 days.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Dockerfile.

Its closest alternative on selfhost.directory is openhands (87/100, 92 919 stars). It scores higher overall, so compare the two before you pick. See Visual Studio Code Server vs openhands side by side.

Features

  • Browser-based VS Code
  • Configurable default workspace
  • Docker Mods extensibility
  • Git/GitHub use inside the container
  • Non-root operation
  • Persistent /config volume
  • Read-only container filesystem
  • Secrets via files
  • Subdomain proxying
  • Sudo access in container terminal
  • Web UI password protection

Visual Studio Code Server README

linuxserver.io

Blog Discord Discussions GitHub Open Collective

The LinuxServer.io team brings you another container release featuring:

  • regular and timely application updates
  • easy user mappings (PGID, PUID)
  • custom base image with s6 overlay
  • weekly base OS updates with common layers across the entire LinuxServer.io ecosystem to minimise space usage, down time and bandwidth
  • regular security updates

How to install Visual Studio Code Server

Install Visual Studio Code Server with Docker

Environment variables
PUID, PGID, TZ, PASSWORD, HASHED_PASSWORD, SUDO_PASSWORD, SUDO_PASSWORD_HASH, PROXY_DOMAIN, DEFAULT_WORKSPACE, PWA_APPNAME
docker run -d \
  --name=code-server \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e PASSWORD=password `#optional` \
  -e HASHED_PASSWORD= `#optional` \
  -e SUDO_PASSWORD=password `#optional` \
  -e SUDO_PASSWORD_HASH= `#optional` \
  -e PROXY_DOMAIN=code-server.my.domain `#optional` \
  -e DEFAULT_WORKSPACE=/config/workspace `#optional` \
  -e PWA_APPNAME=code-server `#optional` \
  -p 8443:8443 \
  -v /path/to/code-server/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/code-server:latest

How to configure Visual Studio Code Server

  • PUID1000User ID the container runs services as, to avoid volume permission problems.
  • PGID1000Group ID the container runs services as.
  • TZEtc/UTCTimezone to use inside the container.
  • PASSWORDOptional web gui password; if PASSWORD or HASHED_PASSWORD is not provided there is no auth.
  • HASHED_PASSWORDOptional web gui password given as a hash, overrides PASSWORD.

Visual Studio Code Server releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Developer Tools

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…