diff --git a/.media/image24.png b/.media/image24.png
new file mode 100644
index 0000000000000000000000000000000000000000..7990ccce5cf571f2cfd8a172b987efcd986472b4
Binary files /dev/null and b/.media/image24.png differ
diff --git a/.media/image25.png b/.media/image25.png
new file mode 100644
index 0000000000000000000000000000000000000000..e5725826b85a6ce75d3fac58bfca04b81fa497dd
Binary files /dev/null and b/.media/image25.png differ
diff --git a/.media/image26.png b/.media/image26.png
new file mode 100644
index 0000000000000000000000000000000000000000..e91a0d85ec3935f07d132fdbd4ebc4275055186e
Binary files /dev/null and b/.media/image26.png differ
diff --git a/.media/image27.png b/.media/image27.png
new file mode 100644
index 0000000000000000000000000000000000000000..894e1e3e1779e9dba9584c92ea17b342836862aa
Binary files /dev/null and b/.media/image27.png differ
diff --git a/.media/image28.png b/.media/image28.png
new file mode 100644
index 0000000000000000000000000000000000000000..7a331aebf35ada0525cffa46016ecab3f45c746f
Binary files /dev/null and b/.media/image28.png differ
diff --git a/.media/image29.png b/.media/image29.png
new file mode 100644
index 0000000000000000000000000000000000000000..1b256c4cf8afd931b60fc788669c4f78c3b40cd5
Binary files /dev/null and b/.media/image29.png differ
diff --git a/.media/image30.png b/.media/image30.png
new file mode 100644
index 0000000000000000000000000000000000000000..6b1ce45b7071b24178d61ee307d7dc1d5cc7b10e
Binary files /dev/null and b/.media/image30.png differ
diff --git a/.media/image31.png b/.media/image31.png
new file mode 100644
index 0000000000000000000000000000000000000000..1612c96f2cbe58fa87917a7cd71d630f54a6d5eb
Binary files /dev/null and b/.media/image31.png differ
diff --git a/.media/image32.png b/.media/image32.png
new file mode 100644
index 0000000000000000000000000000000000000000..f016c4e850722a73f8b8d2d761611b02e67ba5c4
Binary files /dev/null and b/.media/image32.png differ
diff --git a/.media/image33.png b/.media/image33.png
new file mode 100644
index 0000000000000000000000000000000000000000..3c59f660be6742d4af48263cdb1ead3b8916891c
Binary files /dev/null and b/.media/image33.png differ
diff --git a/README.md b/README.md
index a0725b2ad0f65047034ae7f3b0f88a7316d69925..97d44ea387fdc34c02111b38cb5c9b8ac134d979 100644
--- a/README.md
+++ b/README.md
@@ -4,9 +4,11 @@ The objective of this repo is to provide guidance on how to enroll in the EMERAL
 
 In order to enroll a project such as EMERALD, you need to follow the next steps:
 
-* register in git.code.tecnalia.com with orein
-* login to git.code.tecnalia.com
-* request access to the project responsible
+* [register in git.code.tecnalia.com with orein.](#register-in-gitcodetecnaliacom-with-orein)
+* [login to git.code.tecnalia.com](#login-to-gitcodetecnaliacom)
+* [request access to the project responsible](#request-access-to-the-project-responsible)
+
+We included a section for trouble shooting in case of sign-up or sign-in issues. [Trouble shooting](#trouble-shooting)
 
 ## Register in git.code.tecnalia.com with orein
 First of all you have to create an account in git.code.tecnalia.com so that you can be added latter to a project. In order to create an account:
@@ -99,7 +101,7 @@ That will drive you to the welcome page or the group page where you have clicked
 ## Request access to the project responsible
 
 There are two ways to request access to the project.
-- Send an email to a project owner https://git.code.tecnalia.com/groups/emerald/-/group_members
+- Send an email to a [project owner](https://git.code.tecnalia.com/groups/emerald/-/group_members)
 - Once you are logged in you can request access. Clicking the request access button.
 
 ![Request Access](.media/image22.png)
@@ -107,3 +109,80 @@ There are two ways to request access to the project.
 ## Trouble shooting
 
 In case of sign-up or sign-in issues contact project owners https://git.code.tecnalia.com/groups/emerald/-/group_members at tecnalia.
+
+- [Lost of Authenticator](#lost-of-authenticator)
+- [Lost of the recovery codes](#lost-of-the-recovery-codes)
+- [Lost of the password](#lost-of-the-password)
+- [Lost of authenticator and recovery codes](#lost-of-authenticator-and-recovery-codes)
+
+
+### Lost of Authenticator
+
+In case you have lost the authenticator access your configuration page in orein.
+
+![Orein login page with data](.media/image19.png)
+
+After login you can be asked for the 2FA code. Use a recovery code as you have not the authenticator.
+
+![2FA request](.media/image20.png)
+
+Once you are in
+
+![Welcome to gitlab](.media/image24.png)
+
+Go to the [account](https://git.code.tecnalia.com/-/profile/account) section in the profile menu.
+
+![Profile account](.media/image25.png)
+
+The configuration page you that bring you to the [2FA configuration](https://git.code.tecnalia.com/-/profile/two_factor_auth).
+
+![2FA configuration](.media/image26.png)
+
+In this case as described in the `Register a one-time password authenticator`you have to first to `Disable two-factor authentication` (1) and then register again.
+
+![2FA](.media/image06.png)
+
+Following the procedure shown in the [register in git.code.tecnalia.com with orein.](#register-in-gitcodetecnaliacom-with-orein) section. Do not forget to take note of the recovery codes.
+
+![2FA Success](.media/image27.png)
+
+### Lost of the recovery codes
+
+In case you have lost the recovery codes you can recover them from the the [2FA configuration](https://git.code.tecnalia.com/-/profile/two_factor_auth). 
+
+![2FA configuration](.media/image26.png)
+
+There you can `Regenerate recovery codes` (2) to create a new set of recovery codes.
+
+### Lost of the password
+
+In case you have lost the password you can reconfigure it from the Orein login page.
+
+![Orein login page](.media/image03.png)
+
+In this case you have to click on the `Forgot your password?` (6) link. This will request your email.
+
+![Request password recovery](.media/image28.png)
+
+![Forgot Password Confirmation](.media/image29.png)
+
+You will receive an email with a link to reset the password.
+
+![Reset mail](.media/image30.png)
+
+After you click on the link `here` you will be asked to set a new password.
+
+![Forward change form](.media/image31.png)
+
+From there, your request can be directly accepted.
+
+![Forward change form](.media/image32.png)
+
+From there, you will be forwarded to the login page. After login you can be asked for the 2FA code. In case you have lost the authenticator you can use the recovery codes.
+
+![2FA code request](.media/image33.png)
+
+
+### Lost of authenticator and recovery codes
+
+In case you have lost the authenticator and the recovery codes you can request a `2FA reset` to your account by contacting the [project owner](https://git.code.tecnalia.com/groups/emerald/-/group_members) at tecnalia.