

Generate a key pair
Pick a name and (optional) password
The default name
id_rsa matches the OpenSSH convention and is fine. A password protects the private key on disk; you’ll have to type it (or unlock it via ssh-agent) every time you connect. For an automated job, leave the password blank.Choose the key type
ed25519 is the modern default; faster, shorter, and at least as secure as RSA. Pick RSA 4096 if you have to interoperate with old clients that don’t speak ed25519. Skip dsa, it’s deprecated.Authorize a key for login
A generated or imported public key sits on the server but doesn’t grant access until you authorize it. The Manage SSH Keys page shows every key it knows about with an Authorize / Deauthorize button next to each.- Authorize appends the public key to
~/.ssh/authorized_keys. Anyone holding the matching private key can now log in as your cPanel user. - Deauthorize removes the line. Existing sessions stay open, future logins are denied.
Import a key you already have
If you already have an SSH key pair on your laptop, import the public half rather than generating a new one:Paste the public key
Open
~/.ssh/id_rsa.pub (or id_ed25519.pub) on your local machine, copy the single line, paste into cPanel’s Public Key field.Skip the private key field
Don’t paste your private key into a server you don’t control. cPanel only needs the public half to authorize logins.
Connect from your local machine
Standard OpenSSH. Once a key is authorized:~/.ssh/id_rsa or ~/.ssh/id_ed25519, point at it explicitly with -i:
Common issues
Permission denied (publickey)
Permission denied (publickey)
Three usual causes: the key isn’t authorized in cPanel, you’re connecting with the wrong username, or the local SSH client is offering a different key than the one you authorized. Run with
-vvv to see which key OpenSSH is sending; check the username matches your cPanel account.The cPanel terminal won't open
The cPanel terminal won't open
cPanel’s in-browser Terminal tool requires shell access to be enabled on the account. Some Noxity plan tiers don’t include it. Open a ticket if you need it enabled.
I lost the private key
I lost the private key
There’s no recovery. Generate a new key in cPanel, authorize it, deauthorize the lost one. Treat the lost key as compromised.
"Too many authentication failures"
"Too many authentication failures"
OpenSSH offers every key in your
~/.ssh/ to the server before falling back to password. With many keys loaded into ssh-agent, the server hits its retry limit before the right key is tried. Use ssh -o IdentitiesOnly=yes -i /path/to/correct-key to force one specific key.
