Adding a public key
An SSH public key is required to SSH to servers and environments of sites. You can also use your public key to access your servers using SFTP or rsync, or to access your Git repository.
Adding an SSH key to your Acquia account
You can add a public key to your Acquia account. If you have the proper role and permission as a member of a team, you can then use your public key to SSH to servers and environments of sites your team is assigned to. You can also use your public key to access your servers using SFTP or rsync, or to access your Git repository.
After you have added your SSH public key to your account, you can use it to access an Acquia Cloud server or environment, if:
- You are a member of a team that is assigned to the server's site, and you have a role that includes the appropriate SSH permissions, or
- You are either be a primary or technical contact for the site.
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 site's Git repository, as well as use SSH to connect to your site's Dev and Stage environments, but you cannot connect to your site's Production environment using SSH. Learn more about teams and permissions.
To add a public key to your account:
- Click your name in the upper right of the Acquia user interface, then click View profile to open your Acquia profile.
Or, just click here.
- In your Acquia profile, click Credentials.
- On the Credentials page, under SSH keys, click Add SSH key.
- Enter the SSH key nickname, such as the name of the person who owns the key.
- Using a text editor, open your SSH public key file, and then copy the contents of the file to the clipboard, ensuring that you don't add any extra lines or spaces to the copied key.
By default, the file name is
If you can't either view or edit the public key file
If you can't either view or edit your public key file using a text editor, use a command like one of the following to copy the contents of the key file directly to the clipboard:
pbcopy < ~/.ssh/id_dsa.pub
sudo apt-get install xclip
xclip -sel clip < ~/.ssh/id_dsa.pub
- Windows with GitBash
clip < ~/.ssh/id_dsa.pub
- Paste the OpenSSH-formatted key into the SSH public key field. OpenSSH public keys start with
ssh-rsa, and appear similar to the following example:
- Click Add key.
Entering the 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 servers 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 sites. Once deleted, site-wide SSH public keys cannot be restored.