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.