Last updated on 5th March 2026

Global SSH Keys

Global SSH keys allow you to manage SSH keys at the account level and reuse them across multiple projects and servers in DeployHQ. Instead of managing separate keys for each project, you can create a single key and assign it wherever needed.

Creating global SSH keys

To create a global SSH key, go to your DeployHQ account settings by clicking on "Settings" in the top bar, then click on "SSH Keys" in the left column.

Global SSH key config location

Click "New SSH Key" to create a new key. You can select the encryption type, and optionally provide a custom key by clicking "Use custom key?".

Once created, the key will be available for use across your account.

Using global keys with projects

You can assign a global SSH key to a project during project creation. On the first page of the project configuration, click "Advanced options", then select "Use a global SSH key" from the dropdown and choose the key you want to use.

Add Global SSH key to new project interface

The project will use the selected global key as its default key for repository access and any servers that use the project key.

Using global keys with global servers

When creating or editing a global server that uses an SSH-based protocol (SSH/SFTP, Rsync, or Shell), you can select a global SSH key from the key selector dropdown. The selected key will be used for authentication when the global server is added to projects.

For more information about global servers, see Global Servers.

Using global keys with project servers

When creating or editing a server within a project, SSH-based servers (SSH/SFTP, Rsync, or Shell) display a key selector dropdown in the Authentication section. This dropdown lets you choose between:

  • Use project key (default) -- The server uses the project's own SSH key for authentication.
  • Any global SSH key -- The server uses the selected global key instead of the project key.

When you select a global key, the Authentication section updates to display that key's public key, which you can then install on your server.

Key resolution

When DeployHQ connects to a server during a deployment, it determines which SSH key to use based on the following logic:

  • If a global SSH key is selected on the server, that key is used for authentication.
  • Otherwise, the project's own SSH key is used.

This applies to all SSH-based protocols: SSH/SFTP, Rsync, and Shell servers.

Managing global SSH keys

You can manage all your global SSH keys from Settings > SSH Keys. Note that a global SSH key cannot be deleted if it is currently in use by any global server. You will need to change the key selection on those servers before you can remove the key.