Logging in to Minder
To start using Minder, you must first log in. Logging in to a Minder server for the first time will create your account.
By default, the Minder CLI will log in to Minder Cloud, Stacklok's hosted instance of Minder. If you have a separate instance of Minder, you can log in to that server instead.
Prerequisites
Before you can log in, you must have installed the minder
CLI application.
Logging in to the Stacklok-hosted instance
The minder
CLI defaults to using the hosted Stacklok environment. When using the hosted environment, you do not need to set up a server; you simply log in to the Stacklok authentication instance using your GitHub credentials.
You can use the Stacklok hosted environment by running:
minder auth login
A new browser window will open and you will be prompted to log in to the Stacklok instance using your GitHub credentials. Once you have logged in, proceed to enroll your credentials in Minder.
Logging in to your own Minder instance
To log in to a Minder server which you are running (self-hosted), you will need to know the URL of the Minder server and of the Keycloak instance used for authentication. If you are using docker compose
to run Minder on your local machine, these addresses will be localhost:8090
for Minder and localhost:8081
for Keycloak.
You can log in to Minder using:
minder auth login --grpc-host localhost --grpc-port 8090 --identity-url http://localhost:8081
Your web browser will be opened to log in to Keycloak, and then a banner will be printed an
You have successfully logged in.
Here are your details:
┌────────────────────────────────────────────────┐
│ Key Value │
│ Project Name KeyCloak-username │
│ Minder Server localhost:8090 │
└────────────────────────────────────────────────┘
Your access credentials have been saved to ~/.config/minder/credentials.json
Once you have logged in, you'll want to enroll your GitHub credentials in Minder so that it can act on your behalf.