Step 3, Enable Secure Shell (SSH)

The SSH protocol is designed to maintain a secure connection between two systems—in this case, your local working environment and your Magento Enterprise Cloud Edition Git project.

You must create an SSH keypair on every machine with which you and your team expect to interact with Magento Enterprise Cloud Edition. You must set up SSH keys as the Magento file system owner.

Locate an existing SSH keypair

An existing SSH keypair is typically located in the .ssh subdirectory of the user’s home directory. To see if you already have keys, enter the following command:

ls ~/.ssh

If you have SSH keys, a directory listing is displayed similar to the following:

id_rsa  id_rsa.pub  known_hosts

If you don’t have SSH keys, continue with the next section.

If you already have SSH keys, you can skip the next section and continue with Add a public SSH key to your account.

Create a new SSH keypair

Use the ssh-keygen command to create an SSH keypair. ssh-keygen is typically installed on Linux systems.

For more information:

The command syntax follows:

ssh-keygen -t rsa -C "your_email_address@example.com"

Follow the prompts on your screen to complete the task.

Add a public SSH key to your account

You can add SSH keys to your account in any of the following ways:

Add a key using the CLI

To add an SSH key using the CLI:

  1. If you haven’t done so already, log in (or switch to) the Magento file system owner to the server on which your SSH keys are located.
  2. Log in to your project:

    magento-cloud login
    
  3. Add the key:

    magento-cloud ssh-key:add ~/.ssh/id_rsa.pub
    

Add a key using the Web Interface

To add an SSH key using the Web Interface:

  1. Copy your SSH public key to the clipboard.

    If you don’t already have SSH keys on that machine, see GitHub documentation to create them. 2. Using the link in your welcome e-mail, access your Magento Enterprise Cloud Edition account.

  2. Log in to your project using Bitbucket, GitHub, Google, or a user name and password.

    Log in to a project

  3. In the upper right corner of the page, click the Account Settings tab as the following figure shows.

    Account settings

  4. Expand SSH Keys.
  5. On the next page, click Add a public key as the following figure shows.

    Add an SSH public key to your account

  6. Follow the prompts on your screen to complete the task.

Next step

Step 4, Install Magento prerequisites