You can open a Gitpod environment directly using a URL. The simplest way to start an environment is by using the format: 
https://app.gitpod.io/#<repository-url>
This provides an alternative to creating environments with the browser extension.

​
URL Structure

The URL consists of the Gitpod instance URL followed by # and the full repository URL.

​
Examples

  • https://app.gitpod.io/#https://github.com/gitpod-io/empty
  • https://app.gitpod.io/#https://gitlab.com/gitpod-io/empty
  • https://app.gitpod.io/#https://bitbucket.org/gitpod-io/empty

​
Choosing a Runner and Environment Class

When you open a repository in Gitpod, you will be prompted to choose a runner and environment class. To configure a default for the environment class and runner for a repository, create a Project with your preferred configuration. When a project exists on a repository users in your organization are trying to open, it will be selected automatically.

​
Next Steps

  • Configure your user settings to set default preferences such as your preferred editor
  • Learn about organization policies for team-wide configurations such as requiring users to use a project when creating an environment