Saltar al contenido
Facturador

Cambiar la contraseña root en MariaDB

Si olvidó o extravió la contraseña del superusuario root de MariaDB dentro del contenedor Docker, siga estos pasos para omitir temporalmente la tabla de privilegios y asignar una nueva clave.


Antes de empezar

  • Acceso SSH como root (Conexión remota).
  • Ubique la carpeta del facturador, donde está docker-compose.yml.

La base de datos queda sin contraseña mientras sigue estos pasos

Con --skip-grant-tables, cualquiera que llegue al puerto de MariaDB puede entrar sin contraseña. Haga todos los pasos seguidos y no deje el servidor en ese estado.

Pasos

  1. Abra el archivo docker-compose.yml de su proyecto y agregue temporalmente la siguiente instrucción entrypoint en la sección del servicio de MariaDB:

    entrypoint: mysqld_safe --skip-grant-tables --user=mysql
    
  2. Reinicie el stack de Docker para aplicar el cambio:

    docker compose up -d
    
  3. Ingrese a la consola del contenedor:

    docker exec -ti [nombre_contenedor_mariadb] bash
    
  4. Conéctese a MariaDB sin contraseña:

    mysql -u root
    
  5. Actualice la contraseña del usuario root:

    FLUSH PRIVILEGES;
    ALTER USER 'root'@'localhost' IDENTIFIED BY 'nueva_contrasena_segura';
    ALTER USER 'root'@'%' IDENTIFIED BY 'nueva_contrasena_segura';
    FLUSH PRIVILEGES;
    EXIT;
    
  6. Salga del contenedor (exit).

  7. Retire la línea entrypoint: ... que agregó en docker-compose.yml. En el archivo .env actualice MYSQL_ROOT_PASSWORD y, si la aplicación se conecta con el usuario root, también DB_PASSWORD.

  8. Reinicie el contenedor en modo estándar:

    docker compose down
    docker compose up -d
    

Cómo verificar

  1. Valide el acceso con la nueva clave:

    docker exec -ti [nombre_contenedor_mariadb] mysql -u root -p
    
  2. Abra el facturador e inicie sesión. Si carga, la aplicación se conecta bien a la base de datos.

Si algo sale mal

Síntoma Qué hacer
Access denied al validar Repita los pasos 1 a 5; la contraseña no se guardó.
El facturador muestra un error de conexión a la base de datos DB_PASSWORD no coincide con la nueva contraseña. Corríjala y ejecute php artisan config:clear y php artisan config:cache en el contenedor fpm.
MariaDB no arranca después del paso 8 Revise que quitó la línea entrypoint y mire el log con docker logs --tail 100 [nombre_contenedor_mariadb].