Last updated: October 12, 2026
Some links on this page are affiliate links. If you sign up through them I may earn a commission at no extra cost to you.
WP Engine gives you SSH access through what it calls the SSH Gateway. It’s the fastest way to run WP-CLI, export a database, or move a lot of files. Setup takes about five minutes.
Step 1: Add your SSH key
WP Engine only accepts ed25519 keys. If you don’t have one, create it on your computer:
ssh-keygen -t ed25519 -f ~/.ssh/wpengine_ed25519
- Log in to the User Portal and click your profile icon at the top right.
- Choose SSH Keys, or go straight to my.wpengine.com/profile/ssh_keys.
- Click New SSH Key, paste the contents of your
.pubfile on one line, and save.
The key is tied to your user, so it works on every environment you have access to. Give each computer its own key rather than copying one around.
Step 2: Connect
Replace environment with your environment name, in both places:
ssh environment@environment.ssh.wpengine.net
If you have several keys, tell SSH which one to use. The gateway disconnects you after six failed keys, so this matters:
ssh -i ~/.ssh/wpengine_ed25519 -o IdentitiesOnly=yes environment@environment.ssh.wpengine.net
Or add this to ~/.ssh/config once and forget about it:
Host *.ssh.wpengine.net
IdentityFile ~/.ssh/wpengine_ed25519
IdentitiesOnly yes
Step 3: Go to your site
You don’t land in your WordPress folder. Move there first:
cd sites/environment
From there you can run WP-CLI, the MySQL client, Composer, rsync, and editors like Vim.
Gotchas
- Only your site folder persists. Anything outside
/sites/environment/, including your home folder and /tmp, is wiped when the session ends. - Use _wpeprivate for scratch files. It’s inside the site folder, persists, and isn’t reachable from the web. Good for database exports.
- 10-minute timeout. Sessions time out, so batch long jobs.
- No root or sudo, and no server logs. Logs are in the User Portal.
- No portal tasks. You can’t purge the cache or add users over SSH.
- Five connections per user at a time.
Shopping for a host with real SSH and Git access? WP Engine includes both, plus staging, on every plan.
FAQ
What is the WP Engine SSH command?
ssh environment@environment.ssh.wpengine.net, replacing environment with your environment name in both places.
What kind of SSH key does WP Engine need?
An ed25519 key. Add the public key in the User Portal under your profile, then SSH Keys.
Why are my files gone after I disconnect from WP Engine SSH?
Only files inside /sites/environment/ persist. Save anything you need to keep there, ideally in the _wpeprivate folder.