Adding a public key

An SSH public key is required to connect to Acquia Cloud environments using SSH. You can also use your public key to access your Acquia Cloud environments using SFTP or rsync, or to access your Git repository.

Adding an SSH key to your Acquia profile

You can add a public key to your Acquia profile. If you have the proper role and permission as a member of a team, you can then use your public key to SSH to environments of websites that your team is assigned to. You can also use your public key to access your environments using SFTP or rsync, or to access your Git repository.

If you do not already have an SSH private/public key pair, you can create a new key.

After you have added your SSH public key to your profile, you can use it to access an Acquia Cloud environment, if you meet either (or both) of the following requirements:

  • You are a member of a team that is assigned to the server's website, and you have a role that includes the appropriate SSH permissions.
  • You are either a primary or technical contact for the website.

Acquia provides the following permissions related to SSH keys:

  • Add SSH key to Git repository
  • Add SSH key to non-Production environments
  • Add SSH key to the Production environment

So, if you have just the Add SSH key to git repository and Add SSH key to non-Production environments permissions, you can check code into and out of your website's Git repository, as well as use SSH to connect to your website's Dev and Stage environments, but you cannot connect to your website's Prod environment using SSH. Learn more about teams and permissions.

To add a public key to your account, complete the following steps:

  1. Sign in to Acquia, and then open your Acquia profile using one of the following methods:
  2. In your Acquia profile, click Credentials.
  3. On the Credentials page, in the SSH keys section, click the Add SSH key link.
  4. In the Nickname field, enter the SSH key nickname (such as the name of the person who owns the key).

    Add SSH Key

  5. Using a text editor, open your SSH public key file, and then copy the contents of the file to the clipboard, ensuring that you do not add any extra lines or spaces to the copied key.

    By default, the file name is ~/.ssh/ or ~/.ssh/

  6. Paste the OpenSSH-formatted key into the Public key field.
    OpenSSH public keys start with ssh-dss or ssh-rsa, and appear similar to the following example:

    ssh-dss  AAAAG1bB0us3MAAACBALFF6+dpSkO6bwbJ6BCCwbGavQPqR3JSwGWWm1ZCg2
    Zb6r1IZJmx+/ORjcg== user@hostname
  7. Click Add key.

After you add a key, there can be a delay of approximately a minute before you can use the key to connect to your environments or repository.

About per-site SSH keys

Some Acquia Cloud websites may also have site-wide SSH public keys. Using per-user SSH public keys is recommended and site-wide SSH public keys can no longer be added to Acquia Cloud websites. Once deleted, site-wide SSH public keys cannot be restored.

Add new comment

Plain text

  • No HTML tags allowed.
  • Lines and paragraphs break automatically.
  • Web page addresses and email addresses turn into links automatically.
By submitting this form, you accept the Mollom privacy policy.

Contact supportStill need assistance? Contact Acquia Support