vscode.md

title	VS Code
description	Launch code-server (VS Code Web) in OpenSandbox to provide browser-based IDE access.

VS Code Example

Launch code-server (VS Code Web) in OpenSandbox to provide browser access.

Build the VS Code Sandbox Image

The Dockerfile in the example directory builds a sandbox image with code-server pre-installed:

cd examples/vscode
docker build -t opensandbox/vscode:latest .

This image includes:

• code-server (VS Code Web) pre-installed
• Non-root user (vscode) for security
• Workspace directory at /workspace

Start OpenSandbox server [local]

Pre-pull the VS Code image:

docker pull sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/vscode:latest

Start the local OpenSandbox server:

uv pip install opensandbox-server
opensandbox-server init-config ~/.sandbox.toml --example docker
opensandbox-server

Create and Access the VS Code Sandbox

# Install OpenSandbox package
uv pip install opensandbox

uv run python examples/vscode/main.py

The script starts code-server (with authentication disabled), binds it to the specified port and outputs the accessible address. Uses the prebuilt VS Code image by default.

References

• code-server (VS Code Web)
• Source code on GitHub