Signing in to GitLab

Joining Redox GitLab

You don't need to join our GitLab to build Redox, but you will if you want to contribute. Obtaining a Redox account requires approval from a GitLab administrator, because of the high number of spam accounts (bots) that are created on this type of project. To join, first, go to Redox GitLab and click the Sign In/Register button. Create your User ID and Password. Then, send a message to the GitLab Approvals room indicating your GitLab User ID and requesting that your account be approved. Please give a brief statement about what you intend to use the account for. This is mainly to ensure that you are a genuine user.

The approval of your GitLab account may take some minutes or hours, in the meantime, join us on the chat and let us know what you are working on.

Setting up 2FA

Your new GitLab account will not require 2 Factor Authentication at the beginning, but it will eventually insist. Some details and options are described below.

Before logging-in, you will need:

Your web browser open at Redox GitLab
Your phone
Your 2FA App installed on your phone.
Add https://gitlab.redox-os.org/redox-os/ as a site in your 2FA App. Once added and the site listed, underneath you'll see 2 sets of 3 digits, 6 digits in all. i.e. 258 687. That's the 2FA Verification Code. It changes every so often around every minute.

2FA Apps

Web Browser

Authenticator extension (open-source)

Linux/Windows

All open-source/free software.

Android

Aegis Authenticator (open-source)
Google Authenticator

iOS

Logging-In in Android

Here are the steps:

From your computer web browser, open the Redox GitLab
Click the Sign In button
Enter your username/email
Enter your password
Click the Submit button
Finally you will be prompted for a 2FA verification code from your phone. Go to your Android phone, go to Google/Aegis Authenticator, find the site gitlab redox and underneath those 6 digits in looking something like 258 687 that's your 2FA code. Enter those 6 digits into the prompt on your computer. Click Verify. Done. You're logged into Gitlab.

Logging-In in iOS

Here are the steps:

From your computer web browser, open the Redox GitLab
Click the Sign In button
Enter your username/email
Enter your password
Click the Submit button
Finally you will be prompted for a 2FA verification code from your phone. Go to your iPhone, go to 2stable/Tofu Authenticator or to your Settings->Passwords for iOS Authenticator, find the site gitlab redox and underneath those 6 digits in looking something like 258 687 that's your 2FA code. Enter those 6 digits into the prompt on your computer. Click Verify. Done. You're logged into Gitlab.

Setting up PAT

Personal Access Token (PAT) is a replacement for passwords when authenticating via Git clients. When pushing code to GitLab, you need to create one.

Here are the steps needed to create a PAT after logging in to GitLab:

Open Personal access tokens in User settings
Click "Generate Token" at the top right of the "Personal access tokens" section, and select "Legacy token"
Enter the token name (can be anything) and expiration date (max is 1 year from today)
Check read_repository and write_repository scopes
Click "Generate Token"
Copy the PAT (displayed as masked password) under the section "Token details"
Save the PAT somewhere safe, like your password manager

When doing git push, you'll be asked for username and password. Enter the password from the PAT token you've created. This will happen every time you run git push. To remember it forever, run the command below to store it later in ~/.git-credentials:

git config --global credential.helper store

If you don't like to store it as plain text, it's also possible to save it only in RAM cache:

# <timeout> is how long it will be preserved in memory, defaults to 900 (seconds)
git config --global credential.helper 'cache --timeout=<timeout>'

If you have lost your PAT, it's OK to create another one.

Keyboard shortcuts

The Redox Operating System