How To Create Admin User Via Command Line In Magento 2

Detailed Steps to Create an Admin User via Command Line in Magento 2

1. Open Your Terminal:

– If you’re on a local machine, open your terminal or command prompt.
– If you’re on a remote server, connect to it via SSH.

2. Navigate to the Magento 2 Root Directory:

Change the directory to where Magento 2 is installed. For example:

cd /path/to/magento2

3. Run the Admin User Creation Command:

Use the `magento admin:user:create` command to create a new admin user. Here is the detailed command with options:

php bin/magento admin:user:create --admin-user='adminusername' --admin-password='adminpassword123' --admin-email='adminemail@example.com' --admin-firstname='Admin' --admin-lastname='User'

Replace the placeholders with actual values:

• `–admin-user`: The desired username for the admin user.
• `–admin-password`: The password for the admin user (must meet Magento’s password strength requirements).
• `–admin-email`: The email address for the admin user.
• `–admin-firstname`: The first name of the admin user.
• `–admin-lastname`: The last name of the admin user.

4. Example Command:

Here’s a complete example:

php bin/magento admin:user:create --admin-user='newadmin' --admin-password='SecurePassword123!' --admin-email='newadmin@example.com' --admin-firstname='New' --admin-lastname='Admin'

 Troubleshooting

Common Issues and Solutions:

1. Permissions:

– Ensure the Magento files have the correct permissions and ownership. For example, if you are using Apache and your user is `www-data`, you might need to set ownership like this:

sudo chown -R www-data:www-data /path/to/magento2

2. Password Requirements:

– Ensure the password meets the Magento 2 requirements: at least 7 characters long, containing both letters and numbers.

3. Clear Cache:

– Sometimes, you may need to clear the cache for changes to take effect:

php bin/magento cache:clean

4. Check PHP Binary:

– Ensure you’re using the correct PHP binary. If you have multiple PHP versions installed, you might need to specify the full path to the correct PHP executable. For example:

/usr/bin/php7.4 bin/magento admin:user:create --admin-user='newadmin' --admin-password='SecurePassword123!' --admin-email='newadmin@example.com' --admin-firstname='New' --admin-lastname='Admin'

5. Verify Magento is Running:

– Ensure that your Magento installation is running correctly and there are no pending setup or deployment steps.

6. Database Connection:

– If there are issues with database connectivity, ensure your `env.php` file in `app/etc/` has the correct database credentials and the database server is running.

 Additional Commands

List Existing Admin Users:

php bin/magento admin:user:list

Delete an Admin User:

php bin/magento admin:user:delete --admin-user='adminusername'

Update Admin User Password:

php bin/magento admin:user:change-password --username='adminusername' --password='newpassword123'

By following these detailed steps and troubleshooting tips, you should be able to create a new admin user in Magento 2 via the command line and resolve common issues that may arise during the process.