Information for: DEVELOPERS   PARTNERS

Generating an SSH key with Dev Desktop

To synchronize a local website with Acquia Cloud, you need to register an SSH key in your Acquia user profile. If you don’t already have one, you can generate a public/private key pair using Acquia Dev Desktop.

Generate a new key

To generate an SSH key pair in Acquia Dev Desktop, complete the following steps:

  1. On the Acquia Dev Desktop menu, click Preferences.

  2. On the General tab, click Generate.

    Generating a key pair

    The SSH key pair dialog box appears with your new public key.

    Copy the public key

  3. Click Copy public key to clipboard. You can use the copied public key to register it with Acquia Cloud.


    Installing a new SSH key that is not yet provisioned in your Cloud account will cause Acquia Dev Desktop to display the following error message: SSH key not yet paired with Acquia Cloud. Allow a few minutes for provisioning to occur.

  4. Use the Key password field to enter an optional password for your key.


    Entering a key password makes your SSH key more secure by requiring you to use the key password whenever you use the key. If you do not associate a password with your key, someone who obtains your key could use it to access certain resources, including your Acquia Cloud websites. Additionally, you may need a password for your key for Payment Card Industry Data Security Standard (PCI DSS) compliance.

  5. Click Save key pair, and in the dialog box that appears, determine the location and file name of the key pair.

  6. Click Save to save the key pair file.

  7. Click Close to close the SSH key pair dialog box.

You now have an SSH key pair that you can use with other services, including Acquia Cloud.

For information about adding the key that you created to Acquia Cloud, see Adding a public key to an Acquia profile. If you copied the key to your clipboard in step 3, you can skip step 5 in the Acquia Cloud-key adding process.

Replacing old keys

If you previously had SSH keys and used the preceding process to create new keys, you may need to refresh your Acquia Cloud websites in Acquia Dev Desktop.

To refresh your websites, complete the following steps:

  1. If the Settings dialog box is still being displayed, click Cancel.
  2. In the bottom left corner, click More.
  3. In the list, click Refresh Acquia Cloud sites.

After the refresh process successfully completes, your local environments should be able to synchronize with your Acquia Cloud websites.