OpenVSCode Server
Run the official VS Code on a remote server and access your full development environment from any device with a modern web browser. Self-host your IDE anywhere.
Run a full, upstream version of Visual Studio Code on a remote machine and access it from any device using a modern web browser. This project provides the server needed to host your own browser-based development environment, built on the same architecture used by services like Gitpod and GitHub Codespaces.
It was created to offer a simple and low-maintenance way to run VS Code remotely, avoiding the complex and error-prone patches required by older methods. Now you can rely on the latest version of VS Code with a clear upgrade path.
Getting started is straightforward. You can launch the server using a pre-built Docker image or by running a binary directly on Linux. The server supports various configurations, including:
- Custom Environments: Easily add dependencies to the Docker image.
- Pre-installed Extensions: Automate the installation of your favorite VS Code extensions.
- Secure Access: Protect your IDE with connection tokens.
This project focuses solely on the server implementation, ensuring that you get a pure VS Code experience without any modifications.
Directory Structure
docker-compose.yml
services:
openvscode-server:
image: gitpod/openvscode-server:latest
container_name: openvscode-server
init: true
restart: unless-stopped
ports:
- "3000:3000"
environment:
- CONNECTION_TOKEN=${CONNECTION_TOKEN}
volumes:
- ./workspace:/home/workspace:cached
.env
# Security token for accessing the Web UI
CONNECTION_TOKEN=your_secure_connection_token_here
Tags:
Similar to OpenVSCode Server