# MnemoSSH - SSH Keys You Can Restore From Words

> MnemoSSH makes an Ed25519 SSH key from a BIP39 mnemonic phrase. Write down 12 or 24 words and you can get the same key back on any machine. Free, open source, MIT.

Canonical: https://oxisoft.io/open-source/mnemossh/

**MnemoSSH** makes an SSH key from a list of words. You get a 12, 18 or 24-word BIP39 phrase and an Ed25519 key that comes from it. Lose the laptop, keep the words, and the same key comes back on a new machine with one command.

It is a small command-line tool and a Rust library, MIT licensed. The keys are normal OpenSSH keys, so every SSH server and tool accepts them.

#### What You Get:

- **Generate** a new phrase and the key that comes from it (`mnemossh generate`)
- **Restore** the same key from the phrase on any machine (`mnemossh restore`)
- **Verify** that a key on disk really matches a phrase (`mnemossh verify`)
- **Inspect** a key: type, comment, MD5 and SHA256 fingerprints (`mnemossh info`)
- **Passphrase** protection for the key file, encrypted the same way `ssh-keygen` does it
- Guided prompts when you leave options out, and a check before it overwrites a key

#### Install

Ready binaries for Linux, macOS and Windows are on the [releases page](https://github.com/abkvme/mnemossh/releases). With Rust installed:

```bash
cargo install mnemossh
mnemossh generate
```

#### Why a phrase

A key file is easy to lose and awkward to back up. A phrase you can write on paper and keep offline. The way the key comes from the phrase is written out in full in the [README](https://github.com/abkvme/mnemossh#key-derivation), so you could rebuild the key even without this tool.

Keep the phrase as safe as the key: anyone who reads it can make your key.

#### Pairs well with Seed Poet

Long word lists are hard to remember. [Seed Poet](/apps/seedpoet/) makes a valid BIP39 phrase that reads as a short rhyming poem. Make your phrase there, then turn it into your SSH key with `mnemossh restore`. The poem is now your key backup, and it is much easier to keep in your head.

#### Links

- Source code: [github.com/abkvme/mnemossh](https://github.com/abkvme/mnemossh)
- Rust crate: [crates.io/crates/mnemossh](https://crates.io/crates/mnemossh)
- More of our open source: [Open-Source Projects](/open-source/)
