OpenVSCode Server — Run VS Code in the Browser on Your Own Server

Introduction

OpenVSCode Server is an open-source project by Gitpod that packages Microsoft's VS Code as a web server. It lets developers access a full VS Code editing environment through any browser, making it possible to develop from tablets, thin clients, or remote machines without installing desktop software.

What OpenVSCode Server Does

• Serves the complete VS Code editor interface over HTTP in any modern browser
• Supports VS Code extensions from the Open VSX marketplace
• Provides integrated terminal access to the server's shell environment
• Enables multi-file editing, IntelliSense, and Git operations through the browser
• Runs on Linux, macOS, or any Docker-capable host as a single process

Architecture Overview

OpenVSCode Server is built directly from the VS Code upstream source with minimal patches. It uses the VS Code remote server architecture where the backend runs language servers, extensions, and terminal processes on the host, while the frontend renders the editor UI in the browser via WebSocket communication. This is the same architecture VS Code uses for its Remote SSH and GitHub Codespaces features.

Self-Hosting & Configuration

• Run via Docker with a volume mount for your workspace directory
• Start natively with ./bin/openvscode-server --port 3000 --host 0.0.0.0
• Set --connection-token or --connection-token-file to require authentication
• Place behind a reverse proxy (Nginx, Caddy) with TLS for secure remote access
• Use --default-folder or --default-workspace to set the startup directory

Key Features

• Tracks upstream VS Code releases closely, typically within days of new versions
• Full extension support including language servers, debuggers, and themes
• Integrated terminal with shell access to the server environment
• Settings sync and portable configuration via settings.json
• Lightweight single-binary deployment with no database or external dependencies

Comparison with Similar Tools

• code-server — Similar concept by Coder; OpenVSCode Server tracks upstream VS Code more closely
• GitHub Codespaces — Cloud-hosted with GitHub integration; OpenVSCode Server is fully self-hosted
• Gitpod — Full cloud dev environment platform; OpenVSCode Server is just the editor component
• Theia — Eclipse-based IDE framework; OpenVSCode Server is actual VS Code code
• JupyterLab — Notebook-focused with code cells; OpenVSCode Server is a full file-based editor

FAQ

Q: Is this the same as code-server? A: No. code-server is a separate project by Coder with its own patches. OpenVSCode Server is maintained by Gitpod and stays closer to the upstream VS Code source.

Q: Can I install VS Code extensions from the Microsoft marketplace? A: OpenVSCode Server uses the Open VSX registry by default. Most popular extensions are available there, though some Microsoft-exclusive extensions are not.

Q: How do I add authentication? A: Use the --connection-token flag for basic token auth, or place the server behind a reverse proxy with OAuth or SSO.

Q: What are the system requirements? A: Minimum 1 GB RAM and 2 CPU cores for basic use. Resource needs scale with the number of extensions and language servers running.

Sources

• https://github.com/gitpod-io/openvscode-server
• https://www.gitpod.io/blog/openvscode-server-launch