Skip to content

Latest commit

 

History

History
 
 

render

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 

Deploy OpenVSCode Server to Render

Prerequisites

To complete this guide, you need:

Setup

To deploy to Render, click the following button and follow the instructions:

Deploy to Render

After that, create a name for the service group (for example OpenVSCode Server) and click Apply.

Start the server

Render starts the server automatically.

Access OpenVSCode Server

When the deployment is complete, you will see your server listed in the Services section of the Dashboard. Click the dashboard entry to see your server URL to access OpenVSCode Server.

image showing where the URL can be found

Teardown

Delete the service in your dashboard.


Deploy Secure OpenVSCode Server to Render with OAuth

Prerequisites

To complete this guide, you need:

Set up provider account

Consult the OAuth2-Proxy Provider Configuration Documentation, and select at least one provider to use for authenticating users of Open VSCode. Create an OAuth application with your provider of choice. For the Homepage/Base URI, enter a placeholder like https://openvscode-secure-server.onrender.com, and for the Callback/Redirect URI, enter a placeholder like https://openvscode-secure-server.onrender.com/oauth2/callback. You will update the OAuth2 app with your URIs once your OAuth2-Proxy Server deployment is complete. Save the Client Secret and ID in a secure place like a password manager for later reference.

Set up Open VSCode Server

To deploy Open VSCode to Render as a private service, click the following button and follow the instructions:

Deploy to Render

After that, create a name for the service group (for example Private OpenVSCode Server) and click Apply.

Start the server

Render starts the server automatically. Copy the service address to the clipboard: Image showing where the service address can be found

Set up OAuth2-Proxy server

Fork the OAuth2-Proxy Render Example Repository. In the Render Dashboard, select YAML from the side navigation and click the New From YAML button: Image showing where to initialize a new service from YAML

After that, use your connected GitHub account or the full URL of your public OAuth-Proxy fork to create a deployment based on the fork.

Configure OAuth server

Create a name for the service group (for example, Secure Access To Open VSCode). Next, enter the environment variable values to configure OAuth.

  • For OAUTH2_PROXY_UPSTREAMS enter the Service Address for Private Open VSCode Server appended by http://
  • For OAUTH2_PROXY_CLIENT_ID enter the Client ID from your OAuth App
  • For OAUTH2_PROXY_CLIENT_SECRET enter the Client Secret from your OAuth App or password manager
  • For OAUTH2_PROXY_PROVIDER enter the name of your OAuth provider

Image showing YAML service creation and input of sync: false values

Start the server

Render starts the server automatically.

Access OpenVSCode Server

When the deployment is complete, you will see your OAuth server listed in the Services section of the Dashboard. Click the dashboard entry to see your server URL to access OpenVSCode Server. You will be prompted to authenticate and then redirected to the private Open VSCode service.

Teardown

Delete the service in your dashboard.