Start here
Get started
Get started on iPhone
Install Nostr Vault on an iPhone or iPad, create a Nostr account or bring the one you have, and find your way around.
Get started on Android
Install Nostr Vault on an Android phone, choose where your notes live, create a Nostr account or bring yours, with Amber or another signer.
Get started on Mac
Install Nostr Vault on a Mac, set it up from the menu bar, and keep your relay running while the app is open.
Use Nostr Vault in a browser
Open the Nostr Vault web app at nostrvault.app/vault/, create an account or sign in with a browser extension, a bunker link or read-only, and know what the web app keeps in your browser.
Keys and accounts
Your keys and accounts
What your Nostr keys are, where Nostr Vault keeps them, and how to add accounts, switch between them, back up your secret key and remove a key.
Signers
Keep your Nostr secret key out of Nostr Vault with a signer: Amber on Android, Clave on iPhone, a bunker link from any signer app, or a browser extension on the web.
Wallet and zaps
How the Nostr Vault wallet works: connect a Lightning wallet with a Nostr Wallet Connect (NWC) link, turn on zap buttons, disconnect, and the on-chain Bitcoin address under Advanced.
Using the app
Feeds
Nostr Vault feeds: Following, Discover, Global, Popular, Media and the rest; Edit Feeds; the Web of Trust shield; languages; reposts, replies and auto-load; and how a new account fills its feed.
Messages and notifications
Nostr Vault messages and notifications: where Messages is, starting a message, NIP-17 and NIP-04, photos, DM relays, who can message you, the Vault activity list, notification settings and in-app pills.
Your web of trust
Nostr Vault's web of trust: the WoT tab globe, layers (Following, Vouched, Further out), Find someone, trust paths, My Web, Rebuild your web, and the Who Can Reach You settings.
Mesh and your devices
The mesh
How Nostr Vault's mesh works: your phone or Mac serves your own photos over the FIPS mesh, with no public IP, domain or cloud. My Devices, kiosk mode, share pages and privacy.
My Devices
Connect your iPhone, Android phone, Mac, home vault and browser page over the FIPS mesh, by address or QR code, so they sync with each other.
Sync with your Mac
Send each new note and photo from your phone to Nostr Vault on your Mac over the mesh, get your history back from the Mac, and check that everything arrived.
Home vault and kiosk mode
Turn a spare phone into an always-on home vault with kiosk mode: it keeps your new posts and media, passes your notes on to your relays, and serves your public photos.
Your Mac as your photo server
Let Nostr Vault on your Mac serve your photos over the FIPS mesh, listed in your media servers, with no public IP, domain or port forwarding.
Remove a device, or a lost phone
Take a device off My Devices so it can no longer reach your vault, and what to do when a phone with Nostr Vault is lost or stolen.
Mesh settings: finder relays and middle server
What the finder relays and the middle server do in Nostr Vault's FIPS mesh settings, what they can see, and when to change them.
The browser relay
The Nostr Vault browser relay at nostrvault.app/relay/: a browser tab that keeps your notes and serves them to your own devices over the FIPS mesh. Pairing, Start FIPS, the screensaver, My Devices and limits.
Your vault
Your vault relay
What the Nostr Vault vault relay keeps on your phone or Mac: your notes, mentions, messages and media. The Vault tab, starting and stopping it, Import Notes, and the Mac and web differences.
Who Can Reach You
Nostr Vault's Who Can Reach You settings: Follow Distance, Minimum Followers and Refresh Trust List decide which people can send to your vault's inbox and messages. Spam control by Web of Trust.
Back up and restore
How to back up and restore Nostr Vault: export and import notes and media in Backup & Restore, restore an old follow list from Following Backup, un-delete posts in Recently Deleted, and the web backup.
Media and sharing
Photos and media servers
Media servers (Blossom) in Nostr Vault: where photos go when you post, adding and removing servers, mirroring copies back to your device, the Media & Cache settings, and uploading from the share sheet.
Share links
How Nostr Vault share links work: Share and Copy Link make a nostrvault.app/thread/ link that opens the post in any browser as a guest, with a link preview card. Plus sharing photos into the app.
Share your profile
Share profile in Nostr Vault: a QR code and a nostrvault.app/p/ link for any profile, Copy link and Share, and what happens when someone scans or opens the link.
Help
Troubleshooting
Fixes for common Nostr Vault problems: empty feed, signer not answering, read-only account, photo posts failing, relays not answering, mesh devices not in reach, Check sync stopping, kiosk mode paused.
FAQ
Nostr Vault FAQ: which version is current, can I use my existing Nostr account, do I need a Mac, is my home IP public, who can see my photos, losing a phone, what the web app does, is it free.
What's new
Nostr Vault release notes for iPhone, Mac and Android: 3.0.0 with the FIPS mesh, and the earlier 2.7.2 builds.
Developers
Can't find it?
Search the docs with the box at the top of the menu. If the answer isn't here, ask on Nostr or open an issue on GitHub.