Devsy
Getting Started

Quick Start

Add a provider, start a workspace, and open it in your editor. First, install Devsy.

Run devsy ide list to see every supported editor. VS Code Browser (openvscode) and none (SSH only) need nothing installed locally. For any other editor, install it first. JetBrains IDEs also need JetBrains Gateway.

Devsy CLI

1. Add a provider

A provider decides where workspaces run. To add local Docker:

devsy provider add docker

For other backends, see Add a Devsy Provider.

2. Start a workspace

Point Devsy at a repository and choose an editor with --ide:

devsy workspace up github.com/microsoft/vscode-remote-try-node --ide vscode

Devsy builds the dev container and opens the editor connected to it. With --ide none, connect over SSH:

ssh WORKSPACE_NAME.devsy

Devsy Desktop

1. Add a provider

Go to 'Providers' and select '+ Add'. Select a provider, then select 'Continue'.

Providers screen with '+ Add' menu open, listing available providers to select
Select Provider

Fill in the provider options if needed, then click 'Add Provider'.

Provider configuration form with an 'Add Provider' button to confirm
Add Provider

2. Start a workspace

Go to Workspaces > + Create and follow the wizard: provider, source (a repository URL or a template), editor, review. When the workspace is ready, the editor opens connected to it.

JetBrains Gateway

For a JetBrains IDE, Gateway opens with a prefilled form. Select Check Connection and Continue to start the IDE inside the workspace.

If you chose None, connect over SSH as shown above.

Environment variables

To use environment variables in devcontainer.json, see Environment variables in devcontainer.json.

On this page