Sign in
You sign in to Gryndel with your GitLab or GitHub account, so there is no separate password. Gryndel sees which GitLab groups or GitHub accounts (organisations, or your personal account) you belong to, and shows you a workspace for each one that has one.
Sign in for the first time
- Open your organisation's Gryndel address, for example https://app.gryndel.com/. Ask your team if you don't know it.
- Click Sign in with GitLab or Sign in with GitHub: the one where your team's code lives. Gryndel only shows the buttons your operator has set up.
- Continue on GitLab or GitHub:
- GitLab
- GitHub
- Sign in to GitLab if you are not signed in already.
- GitLab asks whether to authorize Gryndel. Check that the address bar shows your GitLab server, then click Authorize. (If your operator marked Gryndel as trusted, you won't see this step.)
Signing in only lets Gryndel read who you are and which groups you belong to. It can't change anything in GitLab as you. When you later turn on reviews for a repository, Gryndel asks GitLab for extra permission at that moment, to add the repository's webhook as you.
- Sign in to GitHub (github.com, or your GitHub Enterprise Server) if you are not signed in already.
- The first time, GitHub asks whether to authorize your organisation's Gryndel App. Check that the address bar shows GitHub, then click Authorize.
Gryndel uses your sign-in to find out who you are and which accounts you belong to. It posts reviews as its own App, never as you, and never needs extra permission from you later.
- You're back in Gryndel, in one of your workspaces.
One host at a time
A Gryndel session belongs to the host you signed in with. Signed in with GitLab, you see only GitLab workspaces; signed in with GitHub, only GitHub ones. Your GitLab and GitHub accounts are never linked.
If your teams use both, click Sign out at the top of the page and sign in with the other host to switch.
How long you stay signed in
Your Gryndel session ends when your GitLab or GitHub sign-in token expires. Gryndel doesn't renew it, so you sign in again. On GitHub that is after about eight hours. Signing out ends it straight away.
Switch workspace
If you belong to several groups or accounts with a workspace, choose one in the workspace menu at the top of the page. Your role can be different in each.
Your role
Your role comes from your access on GitLab or GitHub:
| Your access | Your role in Gryndel | What you can do |
|---|---|---|
| GitLab group Owner or Maintainer | Admin (by default) | Everything: repositories, models, rules, members |
| GitLab Developer, Reporter or Guest | Viewer (by default) | See everything, change nothing |
| GitHub organisation owner, or the owner of a personal account | Admin (by default) | Everything |
| GitHub organisation member, or someone else with access to the account's repositories | Viewer (by default) | See everything, change nothing |
Workspace admins can change roles on the Members page.
Gryndel can only tell an organisation's owners from its members if its GitHub App has the Members permission. Without it, everyone is a viewer. See Prepare your GitHub account.
I see no workspace
Gryndel shows a No workspace yet page.
- Nobody has set one up for your group or account yet. GitLab Owners and Maintainers, and GitHub account owners, can create one: click Create a workspace, and see Create a workspace. Otherwise ask one of them.
- You signed in with the other host. Sign out and sign in with GitLab or GitHub, whichever your team's workspace is on.
- You are not in the group or organisation. Ask an owner for access on GitLab or GitHub. Gryndel picks it up within a minute or so.
- On GitHub, the App isn't installed on your account. An owner installs it first. See Prepare your GitHub account.
Next: Your first review.