# Cómo Resetear la Contraseña del Usuario root en GitLab

- Link: https://binariocero.com/linux/como-resetear-la-contrasena-del-usuario-root-en-gitlab
- Published: 2025-06-28T12:40:53+02:00
- Author: Juan José Fernández Durán

![Loading](https://binariocero.com/wp-content/plugins/page-views-count/ajax-loader-
2x.gif)

En entornos de desarrollo y producción donde se utiliza GitLab como plataforma de
control de versiones y DevOps, puede ocurrir que se pierda el acceso a la cuenta`
root` o sea necesario restablecer su contraseña. Afortunadamente, GitLab proporciona
una tarea Rake que permite realizar esta operación de forma sencilla y segura desde
el sistema donde está instalado.

A continuación, te explicamos paso a paso cómo resetear la contraseña del usuario`
root` en una instalación de GitLab CE.

## Requisitos Previos

 * Acceso al servidor donde está instalado GitLab.
 * Privilegios de superusuario (`root`) o acceso con `sudo`.
 * GitLab debe estar instalado como paquete Omnibus (el método más común en instalaciones
   on-premise).

## Pasos para Resetear la Contraseña de `root`

 1. **Accede al servidor**: Conéctate por SSH o accede físicamente al servidor donde
    está instalado GitLab: 
    `ssh usuario@mi-servidor-gitlab`
 2. **Ejecuta la tarea Rake de reseteo**: Ejecuta el siguiente comando para iniciar
    el proceso de cambio de contraseña:
    `sudo gitlab-rake "gitlab:password:reset"`
 3. **Introduce el nombre de usuario**: El sistema te pedirá el nombre de usuario al
    que deseas cambiar la contraseña. En este caso, escribe: 
    `root`
 4. **Escribe la nueva contraseña**: A continuación, se te solicitará la nueva contraseña.
    Escríbela cuidadosamente y presiona Enter.
 5. **Confirmación**: Si todo ha ido bien, verás un mensaje indicando que la contraseña
    ha sido actualizada con éxito.

## Validación

Una vez cambiada la contraseña, abre tu navegador y accede a la URL de tu instancia
de GitLab. Inicia sesión con el usuario `root` y la nueva contraseña para verificar
que los cambios se han aplicado correctamente.

## Notas Adicionales

 * Si el comando `gitlab-rake` no está disponible, asegúrate de que GitLab está 
   correctamente instalado y que estás en el servidor correcto.
 * Para ver todas las tareas Rake disponibles, puedes ejecutar: 
   `sudo gitlab-rake--
   tasks`
 * Este procedimiento solo resetea la contraseña del usuario, no afecta configuraciones
   ni repositorios.

## Recomendaciones de Seguridad

 * Una vez recuperado el acceso, considera desactivar el acceso de `root` si no 
   es estrictamente necesario.
 * Utiliza cuentas de administrador personalizadas y habilita autenticación de dos
   factores (2FA).
 * Realiza auditorías periódicas sobre las cuentas con privilegios elevados en GitLab.