How to Deploy and Use code-server on Oikos OpenHub: Browser-Based VS Code IDE

Code-server is a transformative, open-source solution that allows you to run the full power of Visual Studio Code (VS Code)—the world's most popular code editor—directly in your web browser. By deploying it on the cloud, you can access a dedicated, high-performance remote development environment from any device (laptop, tablet, Chromebook) without needing to install VS Code locally.

Deploying code-server via the Oikos OpenHub Platform-as-a-Service (PaaS) provides an optimized, dedicated, and secure containerized environment, making your entire coding setup available anywhere with an internet connection.

1. Accessing the Oikos OpenHub Catalog#

Access the Oikos Console#

Navigate to OpenHub#

  • Locate: Find the OpenHub option in the left-hand navigation sidebar (standardizing the terminology from Marketplace).
  • Selection: Click OpenHub to view the comprehensive catalog of deployable open-source applications.

Search for code-server#

  • Identify: Use the search bar or direct link to find the code-server application card.

2. Configuring and Initiating Deployment#

Code-server requires robust credentials for access and persistent storage to keep your files, projects, and configurations safe.

Start Deployment and Configuration Review#

  • Action: Click the Deploy option on the code-server application card.

Review Deployment Settings#

  • App Name: Assign a unique name to your cloud IDE instance (e.g., remote-dev-workspace).
  • Cloud Region: Select a Cloud Region closest to your location for minimal latency and a smooth coding experience.
  • Resource Allocation: Review the default CPU and RAM. Allocate sufficient resources, especially if you work with large codebases or resource-intensive tasks (like compiling or running complex tests).

Crucial Persistence: Oikos must ensure a persistent volume is mapped to the container directory (/home/coder). This is critical for safely storing all your project files, local Git configuration, and installed VS Code extensions.

Set Up Access Credentials#

  • Credentials: You will be prompted to create a strong Username and Password. These are the primary credentials required to log in and secure your remote coding environment.

Finalizing Deployment#

  • DNS Resolution: After initiating deployment, the process takes a few moments. You must wait approximately 90 seconds for the domain name system (DNS) to fully resolve the public URL.

  • Completion: Wait for the status indicator to change to Running.

3. Accessing and Utilizing code-server#

Once the status is Running, click Open App and enter your created Username and Password to access the full VS Code interface in your browser.

Key Features for Remote Development#

1. Integrated Terminal Access#

  • Functionality: Use the built-in terminal (accessible via Terminal → New Terminal or `Ctrl+``) to execute shell commands, run local server processes, compile code, and manage dependencies directly within the cloud container.

2. VS Code Extension Marketplace#

  • Extend Functionality: Click the Extensions icon on the sidebar. You can browse, install, and manage extensions just as you would in a desktop VS Code instance. This allows you to integrate linters, debuggers, language support, and themes specific to your projects.

3. Git and Source Control#

  • Version Control: Code-server fully supports Git. Use the Source Control icon to manage file changes, staging, committing, pushing, and pulling from remote repositories. Your code repository is hosted within the persistent Oikos volume.

4. File Management#

  • Project Access: Use the Explorer view to upload, download, and manage your project files, which are securely stored on the dedicated persistent volume.

Core Benefits of Deploying code-server on Oikos#

1. Ubiquitous Access and Portability#

Access your fully configured development environment from any web browser, ensuring maximum portability and removing limitations posed by the local operating system or hardware.

2. High-Performance Development#

Your IDE runs on the reliable, scalable cloud infrastructure provided by Oikos, meaning CPU-intensive tasks run quickly in the cloud rather than taxing your local device.

3. Centralized Environment#

All your settings, extensions, project files, and terminal history are centralized and saved securely on the persistent Oikos volume, ensuring a consistent experience regardless of the device you use.

4. Simplified Setup and Security#

Oikos manages the container orchestration and provides an HTTPS endpoint, securing the connection between your browser and the remote code-server instance.

Official Documentation#

For comprehensive information on advanced configuration, customization, and community contributions:

code-server GitHub Repository: https://github.com/coder/code-server