Users that have administrative access to the Adobe Commerce on cloud infrastructure project can use the following project environment variables to override the configuration settings for the administrative user account to access the Admin UI.
Use the ADMIN variables in the following table to override credentials for the Admin user during Commerce installation.
If you want to change the values after installation, connect to your environment using SSH and use the Adobe Commerce CLI admin:user
command to create or edit the Admin user credentials.
Variable | Default | Description |
---|---|---|
ADMIN_USERNAME |
License Owner email address | A username for the administrative user with the ability to create other users, including administrative users. |
ADMIN_EMAIL |
Email address for the administrative user. This address is used to send password reset notifications. | |
ADMIN_PASSWORD |
Password for the administrative user. When the project is created a random password is generated and an email is sent to the License Owner. During project creation, the License Owner should have already changed the password. You might need to contact the License Owner for the updated password. | |
ADMIN_LOCALE |
en_US |
The default locale used by the Admin. |
Use the following environment variable to secure access to your Admin UI. If specified, this value overrides the default URL during installation.
ADMIN_URL
—The relative URL to access the Admin UI. The default URL is /admin
. For security reasons, Adobe recommends that you change the default to a unique, custom Admin URL that is not easy to guess.
Adobe recommends changing the environment-level variable for the Admin URL after installation. It is a best practice to configure this setting for security reasons prior to branching from the cloned master
environment. All branches created from the master
branch inherit the environment-level variables and their values.
Use the magento-cloud variable:set
command to change the URL. For example, to set the Admin URL to magento_A8v10
, use:
magento-cloud variable:set ADMIN_URL magento_A8v10 -e master
The ADMIN_URL
value accepts letters (a-z or A-Z), numbers (0-9) or underscore character (_) for a custom admin path. Spaces or other characters are not accepted.
To change the URL using the Project Web Interface:
Log in to the Project Web Interface.
In the Project dashboard, select the environment and click Configure environment.
Select the Variables tab.
Click Add Variable.
Enter the following:
ADMIN_URL
magento_A8v10
.By default, Enabled
and Inheritable by child environments
are selected.
Click Add variable and wait until deployment completes.