This page has moved and will be redirected soon. See Migrated topics for the complete list.

Prepare for local environment setup

To develop, deploy, and test Adobe Commerce on cloud infrastructure, you need to setup your local environment and clone your project’s master Git branch. This local environment provides a development system for your custom code, extensions, and configurations to push for active testing in one of the Integration environments.

This section walks through the steps for first time merchants with Adobe Commerce, Adobe Commerce SIs, and existing Adobe Commerce merchants moving to the cloud. If you already completed some of these steps or have an existing Adobe Commerce developer environment, review the following for expected results and continue to the next step. Some configurations and workflows differ for Adobe Commerce than a typical on-premises installation.

Set up an account

To begin working with a project and develop your store, you should have received an e-mail invitation to create a Adobe Commerce on cloud infrastructure account. The account provides access to your project for development and deployment across all supported environments.

You should receive an e-mail invitation to verify and access the project. If you do not see the invitation, check your junk e-mail folder. Click the Verify my account option in the email to verify and access your project account.

When logged in, your project should open with a master branch to work with.

If your Cloud account has access to multiple projects, you should see a list of projects. Select the specific project you are preparing to access and work on.

Commerce-specific tools

When working on your local workstation, you will be accessing the Magento Cloud CLI to issue commands and programmatically complete tasks and the Admin for the store UI and configurations.

You need to set up the file system owner on your local workstation to assign that user as the owner for all created files and directories. For more information, see Overview of ownership and permissions.

This guide assumes you’re working on a UNIX system or in a UNIX shell environment. For MAC OS and Linux-based systems, feel free to use any CLI tools of choice for issuing commands. For Windows users, we recommend a UNIX environment like Cygwin, Putty, or Git Bash.

For development on your local workstation, use any development environment or tools you prefer. For recommendations, many Adobe Commerce developers use tools including WebStorm, PhpStorm, and Atom.

Developing code for Adobe Commerce requires working in Git branches. Not everyone remembers Git commands with ease. If you want a Git client, use any client of your choice. Some developers use clients including GitKraken and SmartGit.


Have the following prepared to complete your initial workspace and project setup:

  • Adobe Commerce on cloud infrastructure account with an added user account
  • Authentication keys from the Commerce Marketplace. If the License Owner or Technical Lead created the project according to these instructions, the Authentication keys should already be installed and available in the auth.json file in the code repository.

Get started

You should be ready to go! The following sections provide a link to the previous step, instructions, and a link to the next step to start developing:

  • Install all prerequisite software and tools on your host system (laptop, desktop, etc) and local workspace (VM)
  • Install Magento Cloud CLI
  • Set up SSH keys
  • Configure the file system owner (optional)
  • Clone and branch the project
  • Install Adobe Commerce
  • Complete configurations and file/folder permissions
  • Verify install, branches, and get to coding!

For Pro projects, you also should deploy across to Staging and Production as part of your set up.

Next step

Install prerequisites