Set up a project and dev workspace

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

This section walks through the steps for first time merchants with Magento, Magento SIs, and existing Magento merchants moving to the cloud. If you have already completed some of these steps or have an existing Magento developer environment, make sure to review the expected results to continue to the next. Some configurations and workflows differ for Magento Commerce than a typical Enterprise Edition 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 Magento Commerce (Cloud) account. The account provides access to your project for Magento development and deployment across all supported environments.

You should receive an e-mail invitation to verify and access the project. If you don’t 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, you should see a named project to select.

If the project name is [UntitledProject], the project administrator (Super User admin) or the account owner needs to create the project, which sets up a master Git repository on the Integration environment. Only one of these users can create the project. For instructions, see Create the Project.

Project owner needs to create the project

Magento specific tools

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

You need to set up the Magento file system owner on your local 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, use any development environment or tools you prefer. For recommendations, many Magento developers use tools including WebStorm, PHPStorm, and Atom.

Developing code for Magento 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:

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 Magento file system owner
  • Clone the project, create a branch
  • Set up Magento authentication keys (encryption keys)
  • Install Magento
  • Complete configurations and file/folder permissions
  • Verify install, branches, and get to coding!

Next step:

Install Magento prerequisites