In order to set up 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 environment you want to log into the User Portal and navigate to the Overview page for your environment, then click on the Git push link on the left.
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.
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 environments.
Should you see an environment name that doesn’t match yours, please keep in mind that the developer keys are often created with the name of the original environment as part of an identifier for the developer. Some of your developers may have developer keys that are tied to environments that are not associated with your account. This does not grant the owners of the referenced environment 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 environments by adding the key and full username (acoolsite-myname in our example above) to the new environment, 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.