Admin variables
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.
Admin credentials
You can override Admin user credentials during Commerce installation with the ADMIN variables in the following table.
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.
ADMIN_USERNAME
ADMIN_EMAIL
ADMIN_PASSWORD
ADMIN_LOCALE
en_US
Admin URL
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.
Change the Admin URL
Adobe recommends changing the environment-level variable for the Admin URL after installation. Configure this setting for security reasons before 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:update
command to update the variable value. (The variable:set
command has been deprecated and is not available.) The following example updates the ADMIN_URL to newAdmin_A8v10
:
magento-cloud variable:update ADMIN_URL --value newAdmin_A8v10 -e master
ADMIN_URL
value accepts letters (a-z or A-Z), numbers (0-9), and the underscore character (_) for a custom admin path. Spaces or other characters are not accepted.To change the URL using the Cloud Console:
-
Log in to the Cloud Console.
-
Select a project from the All projects list.
-
In the project overview, select the environment and click the configuration icon.
img-md w-36 -
Select the Variables tab.
-
Click Create Variable.
-
Enter the following:
- Variable name =
ADMIN_URL
- value = New URL. For example, set the Admin URL to
magento_A8v10
.
By default,
Available during runtime
andMake inheritable
are selected. - Variable name =
-
Click Create variable and wait until deployment completes. This button is only visible when the required fields contain values.