Configuring WordPress to update within the application (i.e. WordPress) is ideal for me because of its convenience. Nonetheless, I'm troubled by the requirements. The requested fields that show up after installing ssh2 for php ask not just my public key, but my private key as well. I would think that, at the most, only the public key would be required.

Does WordPress actually give my private key to a server so that the server can upload the correct software package to my server? I'm familiar with how SSH private/public keys work, which is why I'm confused why WordPress needs this. If anything, I would think that the mechanism for updating wouldn't even need this protocol; it would just use http or ftp to the package server and then download/install/activate from there.

Why does WordPress need my ssh keys? Are there security concerns here?

1 Answer 1


Essentially, WordPress needs to connect back to the server where it is actually running on.

There are several possible ways WordPress can use to write files and thus "overwrite" itself during an upgrade. From a security perspective, the important part of this process is that the new files must have the same ownership as the old files.

So, WordPress performs a test first by writing a file directly and checking who the resulting owner is. If the owner matches the PHP files, then it knows it can write files with the correct ownership (this means that the process is "setuid" to the file owner).

If the resulting file is owned by a different user id (which is likely if Apache/PHP is running as a different user, like the "www" or "apache" user), then WordPress has to use a different method to create files with the correct owner.

One approach is simple FTP. If it makes an FTP connection back to the server it is on, then writes files over that, the resulting files will be owned by whoever it logs in as over FTP. So, it prompts the user for FTP information.

But FTP isn't very secure. So as you have found, another method is via SSH2. Using the SSH library for PHP, it can make an SSH connection back to the server in the same manner. And that is why it needs a private key, because it's using that to make an outgoing connection back to itself. By making that connection, it can set credentials, and write files as the user who has those credentials.

If you're concerned about it having those keys, then generate a new set of keys and use those for this purpose exclusively.

To answer your direct question, no, WordPress does not "give" the keys anywhere. It downloads the upgrade package, unpacks it, and then uses those keys to make a connection back to its own server (loopback, basically), and then copies the files over that connection. In so doing, the credentials mean the files get the correct ownership and avoid the security issues of having the WordPress files owned by the main Apache/www/php process.

  • Great answer. This allayed my concerns. Is this documented anywhere? Commented Sep 17, 2013 at 12:10
  • Yes, although possibly with differing amounts of detail: codex.wordpress.org/Filesystem_API
    – Otto
    Commented Sep 17, 2013 at 13:14
  • when you say make a connection "back to itself". Are you saying that PHP is the FTP client, and connecting to the same server it's running on? Commented Apr 3, 2016 at 3:17
  • Yes, exactly that.
    – Otto
    Commented Apr 3, 2016 at 15:15

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.