Categories
WP Engine

WP Engine SSH: Keys, Connection Command, and Gotchas

How to use WP Engine’s SSH Gateway: add an ed25519 key, connect with the right command, find your site root, and avoid the limits that trip people up.

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
  1. Log in to the User Portal and click your profile icon at the top right.
  2. Choose SSH Keys, or go straight to my.wpengine.com/profile/ssh_keys.
  3. Click New SSH Key, paste the contents of your .pub file 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.

Related

Tell me why I'm wrong...