< ssh.public_key_help >

> shell account access

SSH Public Key

What Mudhaven needs:

Paste your public SSH key into the hosting request. It usually starts with ssh-ed25519 or ssh-rsa. Never paste, upload, or send your private key.

Overview

Public vs Private

Your public key is safe to give Mudhaven. Your private key stays on your computer and proves you are allowed to log in.

Public key:  ~/.ssh/id_ed25519.pub
Private key: ~/.ssh/id_ed25519

Only paste the line from the .pub file.

Windows

PowerShell

Open PowerShell on your own computer. First check whether you already have a key:

Test-Path $env:USERPROFILE\.ssh\id_ed25519.pub

If it says False, create a new key:

ssh-keygen -t ed25519 -C "your-email@example.com"

Press Enter to accept the default save path. A passphrase is recommended, but optional.

Show the public key to copy:

Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub

Copy the full single line and paste it into Mudhaven.

Windows

Git Bash or WSL

If you use Git Bash or WSL, use the Linux-style commands:

ls ~/.ssh/id_ed25519.pub

If the file does not exist, create it:

ssh-keygen -t ed25519 -C "your-email@example.com"

Then show the public key:

cat ~/.ssh/id_ed25519.pub

If you use WSL, remember this key belongs to WSL. If you connect from regular Windows PowerShell, use the PowerShell key instead.

Linux

Terminal

Check whether you already have an Ed25519 public key:

ls ~/.ssh/id_ed25519.pub

If it does not exist, create one:

ssh-keygen -t ed25519 -C "your-email@example.com"

Press Enter to accept the default file path. Then print the public key:

cat ~/.ssh/id_ed25519.pub

Copy the full single line and paste it into Mudhaven.

Paste This

Correct Format

ssh-ed25519 AAAAC3... your-email@example.com

The key should be one long line. Do not add extra line breaks. Do not paste text from id_ed25519; paste from id_ed25519.pub.

After Approval

Connect

After Mudhaven creates your shell account, you will receive a username and host. Your command will look like this:

ssh your_username@mudhaven.net

For SFTP uploads, use the same username, host, and SSH key in your SFTP client.

Troubleshooting

Common Issues

If ssh-keygen is not found on Windows, install the OpenSSH Client from Windows Optional Features or use Git Bash.

If Mudhaven says the key is invalid, make sure it starts with ssh-ed25519, ssh-rsa, or ecdsa-sha2-.

If you lose your private key, generate a new key pair and send the new public key in your hosting notes.