===============
Troubleshooting
===============

.. _troubleshooting-admin-password:

Admin password reset
====================

To reset the password of the admin account use the following command:

.. code-block:: console

    MAYAN_MEDIA_ROOT=<your Mayan media root setting> <installation directory>/bin/mayan-edms.py changepassword admin

If you followed the deploying instructions from the documentation your
``MAYAN_MEDIA_ROOT`` will be ``|MAYAN_MEDIA_ROOT|``.

If using a Docker image, execute the command inside the container. First you
need to know the name of the Docker container running Mayan EDMS on your setup
with:

.. code-block:: console

    docker ps

Then execute the password reset command inside the Docker container:

.. code-block:: console

    docker exec -ti <your docker container name> |MAYAN_BIN| changepassword admin

Another way to do this is to execute a shell inside the container to get a
command prompt:

.. code-block:: console

    docker exec -ti <your docker container name> /bin/bash

And then execute the command:

.. code-block:: console

    |MAYAN_BIN| changepassword admin

