First-time development setup

To create an account and start developing Magento, you need a configured developer workspace, base Magento Commerce (Cloud) code, and knowledge of the deployment workflow. These instructions guide through the entire process to create a development workspace on your local.

Project user account

Depending on the project owner, you may need to be invited by the owner to the project. This account gives you participation to the project and connects your local, credentials, and access to your company’s Magento Commerce account. The account includes all source code and deployment environments.

After you receive an invitation, you can complete tasks to create your local, pull code, and deploy your store.

Helpful knowledge

We highly recommend having experience with the following technologies and methodologies:

  • Magento technology stack
  • Git for repository and code management, branching methodologies, and working with Magento Git code
  • GitHub for managing your code and accessing Magento repos
  • Fastly for CDN and caching, used in Staging and Production
  • Galara Cluster for databases, used in Staging and Production (with triple reduncy failover in Production)

Gather credentials

Prior to setting up your workspace, you may want to gather the following credentials and accounts:

  • Magento Access Key: Provides secure access through a 32-character authentication token. The token authenticates between your account, the Magento 2 code repo (, and any other Git services like GitHub and 3rd party accounts needed for development. You can create multiple Magento access keys. For the workspace setup, you can start with one specific key for your code repository. To generate a key, see Get your authentication keys.
  • Cloud Project account: The Account Owner or project administrator (Super User) should invite you to the Magento Commerce project. When you receive the e-mail invitiation, click the link and follow the prompts to create your account. See Set up an account for details.
  • Magento Encryption Key: When importing an existing Magento system only, you will need to capture the Magento encryption key used to protect your access and data for the Magento

Create a local workspace

For development, you need to install and configure a local workspace. To develop Magento code, you write code in Git branches from the Magento project Gmaster repository on a local system. You need to install a series of applications, configure user accounts and SSH credentials, prior to coding in branches.

For complete steps, see Set up a project and dev workspace.