GitLab First Login¶
This guide walks you through signing in to the Synderys GitLab instance for the first time using your organization credentials.
Before You Begin¶
You will need:
- Your Synderys username and password
- Your enrolled MFA device (authenticator app or security key)
- Project access granted by your team lead or IT (assigned during onboarding)
Sign-In Steps¶
-
Open your web browser and navigate to https://gitlab.synderys.com.
-
On the sign-in page, click the Sign in with Authentik button.
-
You will be redirected to the Authentik login page. Enter your username and password, then click Sign In.
-
Complete the MFA challenge using your authenticator app or security key.
-
After authentication, you will be redirected back to GitLab and signed in automatically.
-
On your first login, GitLab creates your account based on your Authentik profile. You will land on the GitLab Dashboard.
What to expect
Your GitLab account is automatically created on first login using your Authentik credentials. Your display name and email address are pulled from your Authentik profile. You do not need to create a separate GitLab account.
Navigating GitLab¶
After signing in, you will see the GitLab Dashboard with these key areas:
- Projects — your assigned repositories appear here. Click any project name to view its code, issues, and pipelines.
- Groups — projects are organized into groups. Your group memberships determine which projects you can see.
- Merge Requests — view and manage code review requests assigned to you.
- Activity — a feed of recent changes across your projects.
Setting Up Git on Your Machine¶
To clone repositories and push code, configure Git with your Synderys email:
git config --global user.name "Your Full Name"
git config --global user.email "your.name@synderys.com"
Then clone a repository using HTTPS:
git clone https://gitlab.synderys.com/your-group/your-project.git
When prompted for credentials, use your Synderys username and a personal access token (not your password). To create a personal access token:
- In GitLab, click your avatar in the top-left corner and select Preferences.
- In the left sidebar, click Access Tokens.
- Enter a token name (such as "laptop") and an expiration date.
- Select the read_repository and write_repository scopes.
- Click Create personal access token and copy the token immediately — it will not be shown again.
Use this token as your password when Git prompts for credentials.
Troubleshooting FAQ¶
Q: I do not see the "Sign in with Authentik" button on the GitLab login page. : Ensure you are at https://gitlab.synderys.com and not a different GitLab instance. Clear your browser cache if the page appears broken.
Q: I signed in successfully but I do not see any projects. : Your account may not yet be assigned to any projects or groups. Contact your team lead or IT to request access.
Q: GitLab shows my name or email incorrectly. : Your GitLab profile is synced from Authentik. Contact IT to update your details in Authentik, and the changes will take effect on your next login.
Q: I get a "403 Forbidden" error when trying to access a project. : You do not have permission to access that project. Contact the project owner or your team lead to request access.
Q: I forgot my personal access token. : You cannot retrieve an existing token. Revoke the old token in GitLab under Preferences > Access Tokens, then create a new one.