Note: This guide explains how to use a preliminary feature. Don’t expect all the flows to be fully build out, yet.
admin-user
.
Acquire admin login link
The admin login link has the form ofhttps://your-installation.gitpod.cloud/api/login/ots/admin/<token>
, where the token part is compared with a hash of the token stored in a Secret
named admin-credentials
in the default
namespace of the Gitpod installation. It has a data
entry named admin.json
, which is filled with a JSON shape of the form:
We don’t have a common way to manipulate this from the outside, yet. Here is the Go code that Gitpod uses internally.
previewctl
tool in the gitpod-io/gitpod repository:
Log in to the Gitpod installation
After following the link, you should be seeing the Gitpod dashboard, as theadmin-user
.

Logged in as admin-user - Gitpod Dashboard
- All organizations there are on this installation (
admin-user
is made member of all of them on every login) - The “Create Organization” button
As the
Secret
is mounted via kubernetes, it make take some time until the content is reflected in the pod that handles the login request. If you experience an “token expired” message, please wait a bit and try again.Create an additional Organization
After clicking “Create Organization”, choose a name, confirm and the new organization is created.
Create another organization - Create Organization View
Configuring SSO
This can be done under “Organization Settings” -> “SSO” and works as described in Configure SSO.
Setup SSO for that other organization - Setup SSO View
The current process has the limitation that the person who configures SSO also needs to be able to sign-up with it (in order to verify it).
admin-user
).
Login to any organization
To login as regular user again, go tohttps://your-installation.gitpod.cloud/login
, select an organization to log in to by providing the organization name and select “Continue with SSO”.

Login to any organization - Login View
To pre-select an organization to log in with, so users only have to hit “Continue with SSO”, append the search parameter
?orgSlug=<orgName>
to any URL. This works for for workspace creation URLs as well, e.g. https://your-installation.gitpod.cloud/?orgSlug=supercorp#https://github.com/some/repo