Skip to content

Creating new environments

Getting started

A "new environment" in this context is one that contains a supported platform application, and is not an existing project. New environments can be used for testing, development of new features, or as the basis for a project that then can become cloned by other users.


The dx-install command is used to create a new environment.

Guided setup

When you run this command from an SSH command line you will be guided through a set of questions that enable you to define the configuration of your new environment. These questions are:

  1. Project name
    1. This is used to create a new directory within ~/projects/ - therefore, it must be unique.
  2. Application type
    1. For example, Magento 2 or Shopware.
  3. Application version
    1. This allows you to specify a specific version of the application. For Magento 2 you could, for example, specify '2.4.5-p2'.
  4. Edition type
    1. For applications like Magento 2, there are different editions.
    2. This enables you to install, for example, the Open Source or Commerce edition.
    3. In the case of the Commerce edition, you can additionally choose to install the B2B edition.
    4. For Magento, you will need Magento repo access keys.
  5. PHP version
  6. Sample data
    1. Some applications enable you to install sample data.
    2. For example with Magento, you can choose between the standard Luma sample data or extended Magento Performance Toolkit testing data (which is more comprehensive).

The creation of the environment takes around 5 minutes in most cases. For the first environment that you create, it could take significantly longer if the relevant Docker images are not already present in your Cloud DX Server.

What the process looks like

Here is an example of a new environment being setup. It takes around 4 minutes.

Password requirements

Various steps within the installation process require you to authenticate a password. You may see a prompt like...

    [sudo] password for ontap:
... and in this case enter the password provided in your original onboarding email.

Credentials for

For Magento 2 installations, you will be asked to input credentials for If you do not have any, please review this documentation in order to set these up.

Please note, if you want to install the Commerce or B2B editions, then you must use credentials with the necessary permissions to allow that. Please speak to your Adobe representative to facilitate this on your account.

Environment details

Once your environment has been created, you will be given the access details. Please make a note of these somewhere. This includes the web address that you can use to access your application.