code-server

4.141.0-ls371

code-server is VS Code running on a remote server, accessible through the browser. - Code on your Chromebook, tablet, and laptop with a consistent dev environment. - If you have a Windows or Mac workstation, more easily develop for Linux. - Take advantage of large cloud servers to speed up tests, compilations, downloads, and more. - Preserve battery life when you're on the go. - All intensive computation runs on your server. - You're no longer running excess instances of Chrome.

Programming

docker pull lscr.io/linuxserver/code-server:latest

Quick start

Generated from the image's own configuration. Replace the /path/to folders with real paths on your host.

Include optional settings

---
services:
  code-server:
    image: lscr.io/linuxserver/code-server:latest
    container_name: code-server
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - PASSWORD=password # optional
      - HASHED_PASSWORD= # optional
      - SUDO_PASSWORD=password # optional
      - SUDO_PASSWORD_HASH= # optional
      - PROXY_DOMAIN=code-server.my.domain # optional
      - DEFAULT_WORKSPACE=/config/workspace # optional
      - PWA_APPNAME=code-server # optional
    volumes:
      - /path/to/code-server/config:/config
    ports:
      - 8443:8443
    restart: unless-stopped

Parameters

Ports
Port	Function	Required
8443:8443	web gui	required

Environment variables
Variable	Function	Required
PUID=1000	User ID	required
PGID=1000	Group ID	required
TZ=Etc/UTC	Timezone	required
PASSWORD=password	Optional web gui password, if `PASSWORD` or `HASHED_PASSWORD` is not provided, there will be no auth.	optional
HASHED_PASSWORD=	Optional web gui password, overrides `PASSWORD`, instructions on how to create it is below.	optional
SUDO_PASSWORD=password	If this optional variable is set, user will have sudo access in the code-server terminal with the specified password.	optional
SUDO_PASSWORD_HASH=	Optionally set sudo password via hash (takes priority over `SUDO_PASSWORD` var). Format is `$type$salt$hashed`.	optional
PROXY_DOMAIN=code-server.my.domain	If this optional variable is set, this domain will be proxied for subdomain proxying. See [Documentation](https://github.com/coder/code-server/blob/main/docs/guide.md#using-a-subdomain)	optional
DEFAULT_WORKSPACE=/config/workspace	If this optional variable is set, code-server will open this directory by default	optional
PWA_APPNAME=code-server	If this optional variable is set, the PWA app will the specified name.	optional

Volumes
Path	Function	Required
/config	Contains all relevant configuration files.	required

Architectures

Pulling :latest picks the right one for your host automatically.

x86_64amd64-latest
arm64arm64v8-latest

Changelog

20 Sep 2026
Add fallback for legacy or misconfigured systems without IPv6 support.
17 May 2026
Fix container only listening on IPv6 when running non-root.
10 Aug 2025
Let server listen on both ipv4 and ipv6.

Browse all

github-desktop

release-3.4.13-linux1-ls224

Github Desktop is an open source Electron-based GitHub app. It is written in TypeScript and uses React.

5.9M31arm64

vscode

1.142.0-ls30

VS Code is an integrated development environment developed by Microsoft. This container runs the full desktop application, for a web native version see Code Server.

21.3K4arm64

vscodium

1.140.06880-ls294

VSCodium is a community-driven, freely-licensed binary distribution of Microsoft’s editor VS Code.

21K77arm64

vscodium-web

1.140.06880-ls44

vscodium-web is a community-driven, freely-licensed binary distribution of the remote host web component of Microsoft's editor VS Code.

17.5K32arm64