Support

Documentation

User manager

[Note]Note

This only applies to Akeeba Solo (standalone). Akeeba Backup uses the native user management of the site it runs inside.

As you know, Akeeba Solo needs you to log in with a username and password to use it. These are called user accounts, or "users" for short. Each user can have different privileges. This allows you, for example, to have one user which can only take backups but not view or modify the configuration settings. This can come in handy when you want to task someone else with taking and managing backups, but only you have the required access privileges to perform a full configuration of Akeeba Solo. All of this can be performed in the User manager page.

The User manager page

At the top of the page you can find three buttons. New will let you create a new user. Edit lets you edit the selected user. You can select a user by checking the checkbox to its left. Please note that if you have selected multiple users only one of them will be edited (which one depends on the sorting of the page and the IDs of the selected users). The Delete button will remove all selected users. This action is irreversible. If you accidentally delete all users and can no longer log in to Akeeba Solo you will need to create a new super user.

Below that you can see the headers of the table. Clicking on one of the headers will sort the table by this field. Clicking on it again will change the sort order between ascending and descending. The field currently used for sorting is denoted by the small triangle next to its name. The direction of the arrow tells you if the sort order is ascending or descending.

Immediately below you will find the display filters. Entering something here will filter the displayed data to include records that match your filters. For example, you can enter a partial username in the Username filter field to only display users which have that text in their username.

Clicking on any field of each row will open the Edit page, without having to select it and click on the Edit button.

The User editor page

The user editor page is displayed when you are creating a new user or editing an existing one. At the top of the page you can see two buttons. Save & Close will save your settings and return you to the user manager page. Cancel will abort all changes and return you to the user manager page.

You can set up the following fields:

Username

The username of this user. It's best to use only lower and upper case unaccented characters a-z, numbers 0-9, dashes and underscores. Other characters may not work on all servers.

Password

If you are creating a new user, you must enter the password. You cannot have a user with a blank password. It's best to use only lower and upper case unaccented characters a-z, numbers 0-9, dashes and underscores. Other characters may not work on all servers. If you are editing an existing user you don't have to enter a password here unless you wish to change the user's password.

Please remember that passwords are case sensitive. ABC, Abc and abc are three different passwords.

Repeat password

If you had to enter a password above please repeat it here.

Email

Enter the email address associated with this user. Each email address can be associated with only one user; you can't use the same email address on more than one users.

Full name

Enter the full name of the user. This is only for your reference.

Permissions

Choose the permissions of the user:

  • Take backups. Allows the user to take and manage backups.

  • Configure. Allows the user to modify the system and backup profile configuration. Users with this permission activated are called Super Users because they have the rights to create, delete and modify users in the system.

  • Download backups. Allows the user to download backups from the Manage Backups page.

Below that you can find the Two Factor Authentication setup options. This is an optional feature. For more information on what it does and how to enable it please consult the Two Factor Authentication section further below.

Resetting your password or creating a new user if you can't log in to Akeeba Solo

If you have forgot your user's password, or accidentally deleted it or modified its permissions and can no longer log in to Akeeba Solo do not worry. There are two alternative solutions.

1. Doing a partial reinstall. First rename the file Solo/assets/private/config.php to Solo/assets/private/config.php.bak Now just try accessing Solo again. You will see the web installer. Go through it completely, as if you were installing Solo for the first time. Don't worry, your backups will not be lost. Remember to use the same database connection information as your existing Solo installation and the same username as the user you forgot the password for / modified their privileges. After it's finished, rename the config.php.bak file back to config.php and try logging in to Akeeba Solo again.

2. Resetting the password through the database. This is for more advanced users. Using your favourite database editor (e.g. phpMyAdmin) find the table whose name ends in _ak_users. Check the username column to find your user account's record. Change its password column to:

$2y$10$.I8mh9ozEUOyYTWEoZIu9egiUYSqmcUCV5RQ94YdQh.iRqSS2Ijh6

You can now log in using your username and the password changeme (all lowercase, no spaces).

If this didn't work, which is very possible on PHP versions 5.3.9 or earlier, please change the password column to:

MD5:27a7c51de96d731899dc84bb4b9bd521:emergency

and try logging in using your username and the password changeme (all lowercase, no spaces). If both fail please follow the first method.