In order to use Git Push integration with WP Engine, you need to add your SSH Public Key through our User Portal. For more information on Git Push with WP Engine, view our documentation. After generating your SSH Public Key you will add it to the install of your choice in the User Portal. If you need help generating an SSH public key – check out the shell-based instructions on GitHub Help: Generating SSH Keys
Adding a New Key
To add a key to an install you want to log into the User Portal and under the Installs tab, click on the Git Push link on the left under the desired install.
You will want to choose a username that is a good way to identify who the key belongs to, we prefer first initial last name, but anything along those lines is fine. The username you choose will be prepended with the sitename you first set the key up with. So for example if you added a new key to the wpengine install with the username walter, the username will be wpengine-walter.
Note: If you choose a username that is already in use, you will receive an error and will be prompted to choose another username.
Now that you have entered a username you will want to paste in your SSH Public Key, please ensure there are no extra spaces or line breaks before or after the key.
Note: If you receive an error please ensure you are copying directly from the id_rsa.pub file that is created when following the Generating SSH Keys instructions.
Managing Developer Access / Current Developers
Access for managing Git Push developers is available from the User Portal, within the Git Push configuration page, just below the “Add SSH Public Key“ panel. From here, developers can be removed when they’re no longer needed on a project, and their key can be copied to your computer’s clipboard for addition to other installations.
Should you see an installation name that doesn’t match yours, please keep in mind that the developer keys are created with the name of the installation as part of an identifier for the developer. Some of your developers may have developer keys that are tied to installations that are not associated with your account. This does not grant the owners of the referenced installation any unauthorized access to your account, nor does it grant you any unauthorized access to theirs.
Adding an Existing Key
Once you have setup your key the first time it can be added to additional installs by adding the key and full username (wpengine-walter) to the new install, you will receive confirmation at the top of the screen that it has been added. If you attempt to add a key that already exists but provide a different username, you will be prompted to confirm that you want to add the existing username to the install.