jjgroenendijk/arch-vscode repository overview

⁠Arch Linux VS Code Docker Container

Arch Linux development environment running VS Code (code serve-web) in the browser.

⁠Quick Start

mkdir -p ./home
docker run -d \
  -v $(pwd):/workspace \
  -v $(pwd)/home:/home/developer \
  -p 8080:8080 \
  ghcr.io/jjgroenendijk/arch-vscode:latest

Open http://localhost:8080⁠.

⁠Docker Compose

services:
  arch-vscode:
    image: ghcr.io/jjgroenendijk/arch-vscode:latest
    environment:
      - PUID=1000
      - PGID=1000
      - EXTRA_PACKAGES=
      - NPM_PACKAGES=
    volumes:
      - ./:/workspace
      - ./home:/home/developer
    ports:
      - "8080:8080"
    restart: unless-stopped

⁠Configuration

Copy .env.example to .env and edit. Key variables:

See .env.example for the complete list.

⁠Persistence

When ./home is mounted to /home/developer, settings, extensions and shell config persist across restarts. Project files belong in the path mounted to /workspace.

⁠Notes

• VS Code tracks the latest stable release from Microsoft. Override it at build time with --build-arg VSCODE_VERSION=1.130.0 if you need a specific release.
• The container user has passwordless sudo.
• The package database is synced on each start, so EXTRA_PACKAGES works even with an old image.

⁠License

MIT