gitlab-org--gitlab-foss/doc/security/reset_root_password.md
Aaron e7a4c3576e
Add instructions to unlock an account
Originally submitted at
https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6578.

Signed-off-by: Rémy Coutable <remy@rymai.me>
2018-08-29 17:35:36 +02:00

40 lines
751 B
Markdown

# How to reset your root password
Log into your server with root privileges. Then start a Ruby on Rails console.
Start the console with this command:
```bash
gitlab-rails console production
```
Wait until the console has loaded.
There are multiple ways to find your user. You can search for email or username.
```bash
user = User.where(id: 1).first
```
or
```bash
user = User.find_by(email: 'admin@local.host')
```
Now you can change your password:
```bash
user.password = 'secret_pass'
user.password_confirmation = 'secret_pass'
```
It's important that you change both password and password_confirmation to make it work.
Don't forget to save the changes.
```bash
user.save!
```
Exit the console and try to login with your new password.