Run local workspaces using the
run-gp is a CLI tool for running workspaces based on a
.gitpod.yml file locally on your machine. Using a local working copy it produces a workspace image, and starts that workspace. This provides an experience akin to a regular Gitpod workspace.
Warning This is an experiment. When you find an issue, please report it so that we can improve this project.
- ✅ Image Build:
run-gpproduces a workspace image based on the
imagesection in the
.gitpod.yml. If no such section exists,
- ✅ Browser Access: by default we’ll start Open VS Code server to provide an experience akin to a regular Gitpod workspace. This means that a
run-gpworkspace is accessible from your browser.
- ✅ SSH Access: if your user has an SSH key (
~/.ssh/id_rsa.pubfile) present, the run-gp workspace will sport an SSH server with an appropriate entry in authorized_keys. This means that you can just SSH into the
run-gpworkspace, e.g. from a terminal or using VS Code.
- ✅ VS Code extension installation: VS Code extensions specified in the
.gitpod.ymlwill be installed when the workspace starts up. Those extensions are downloaded from Open VSX, much like on gitpod.io.
- ✅ Tasks configured in the
.gitpod.ymlwill run automatically on startup.
- ✅ Ports configured in the
.gitpod.ymlwill be made available on startup. There is no dynamic port exposure you might expect from a Gitpod workspace.
- ✅ Airgapped startup so that other the image that’s configured for the workspace no external assets need to be downloaded. It’s all in the
- ✅ Auto-Update which keeps
run-gpup to date without you having to worry about it. This can be disabled – see the Config section below.
- ⚠️ Docker-in-Docker depends on the environment you use
run-gpin. It does not work yet on MacOS and when
run-gpis used from within a Gitpod workspace.
- ⚠️ JetBrains Gateway support also depends on the environment
run-gpis used in. It is known NOT to work on arm64 MacOS.
gpCLI is coming in a future release.
- ❌ Gitpod Prebuilds are unsupported because this tool is completely disconnected from gitpod.io.
- ❌ Gitpod Backups are unsupported because this tool is completely disconnected from gitpod.io.
- Download the latest release
- In a terminal, navigate to a directory which has a
.gitpod.ymlfile, e.g. a Git working copy of your repository.
- Once the workspace is ready, open the URL displayed in the terminal.
run-gp does not have a lot of configuration settings, as most thinsg are determined by the
.gitpod.yml. You can find the location of the configuration file using
run-gp config path
Auto Update behaviour
run-gp will automatically update itself to the latest version. It does that by checking the GitHub releases of the run-gp repository for a new release.
To disable this behaviour run:
run-gp config set autoUpdate.enabled false
run-gp will send anonymous telemetry. We never send identifiable details such as usernames, URLs or the like. You can review all data ever being transmitted in the sources. To disable telemetry run:
run-gp config set telemetry.enabled false