= How to Link Your GitLab Account to Fedora Account System (FAS)
:toc:
:hide-uri-scheme:

In an effort to provide consistent tooling for all projects under the Red Hat umbrella, more and more projects are being moved from https://pagure.io[Pagure] to the https://gitlab.com/fedora[Fedora space] on GitLab. New projects are actively created in GitLab, so they can make use of the advanced project management tooling available there.

In order to participate in Fedora projects using GitLab, you will need to link your existing GitLab account to FAS or created a new GitLab account for use with Fedora related projects.

Since the process is not very intuitive, we outline the steps below.

== Link existing GitLab account to FAS

=== Prerequisites

You already have a GitLab account that you would also like to use for contributing to Fedora projects. If you'd like to keep separate accounts please read on in <<_create_new_gitlab_account_for_use_with_fedora>>.

=== Step by step

1. Log in to your existing GitLab account
2. Use the https://gitlab.com/groups/fedora/-/saml/sso[SAML link] to link your account to FAS
3. You will be redirected and asked for your FAS credentials if needed
4. Grant permission to Fedorafootnote:permission[The wording may sound alarming. Fedora will not be able to change you existing account. _Management_ refers to granting/denying permissions to projects in the Fedora space.]

== Create new GitLab account for use with Fedora

=== Prerequisites

You don't have a GitLab account yet or you prefer using separate accounts for Fedora participation and other projects hosted on GitLab.

=== Step by step

1. Make sure you are signed out of GitLab (should you have another account)
2. Use the https://gitlab.com/groups/fedora/-/saml/sso[SAML link] to set up a new GitLab accountfootnote:[The new account will inherit your FAS account name.] and link it to FAS
3. You will be redirected and asked for your FAS credentials if needed
4. Grant permission to Fedorafootnote:permission[]

== Recover from mishaps

Since the process of linking GitLab with FAS is not very intuitive, you may end up with two separate accounts in GitLab. To reconcile should this happen, follow the steps below.

=== Step by step

1. Log in to GitLab with the account erroniously set up
2. Disconnect _SAML for Fedora_ in your https://gitlab.com/-/profile/account[account settings]
3. Logout
4. Follow the steps outlined in <<_link_existing_gitlab_account_to_fas>>

In case you need additional help with setting up or configuring your account, please reach out to the https://discussion.fedoraproject.org/tag/red-hat-cpe[CPE team] and/or https://discussion.fedoraproject.org/tag/commops-team[Community Ops team] over on Discussion.

== Unlink your GitLab account

You can _unlink_ your GitLab account from FAS at any time by disconnecting _SAML for Fedora_ in your https://gitlab.com/-/profile/account[account settings].