Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

登入 GitLab

加入 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.

您的 GitLab 帳號審核可能需要幾分鐘或幾小時的時間，在此期間，歡迎加入我們的聊天室，讓我們知道您正在進行的工作。

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 in detail below.

2FA Apps

Requirements Before Logging Into GitLab

在登入之前，您需要：

  • your web browser open at Redox GitLab
  • your phone
  • 您手機上安裝的 2FA 應用程式。
  • to 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.

Available 2FA Apps for Android

On Android, you may use:

Available 2FA Apps for iPhone

On iPhone iOS, you may use:

Logging-In With An Android Phone

Here are the steps:

  • From your computer web browser, open the Redox GitLab
  • 點擊登入按鈕
  • 輸入您的使用者名稱/電子郵件
  • 輸入您的密碼
  • 點擊提交按鈕
  • 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 underneith 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.

使用 iPhone 登入

Here are the steps:

  • From your computer web browser, open the Redox GitLab
  • 點擊登入按鈕
  • 輸入您的使用者名稱/電子郵件
  • 輸入您的密碼
  • 點擊提交按鈕
  • 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 "Add new Token" at the top right of the page
  • Enter the token name (can be anything) and expiration date (max is 1 year from today)
  • Check read_repository and write_repository scopes
  • Click "Create Token"
  • Copy the PAT (displayed as masked password) under the section "Your Token"
  • 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.