Nostr WoT
BeginnerExtensionIdentitySetup

Connect a Nostr signer with a QR code

Use Nostr Connect to pair the extension with an external NIP-46 signer. Scan the QR code, approve the connection and keep signing in your signer.

·2 min read
Connect a Nostr signer with a QR code

Choose Nostr Connect when your Nostr identity is controlled by an external NIP-46 signer. The extension connects to that signer; your identity's signing key stays with it.

Before you begin

Have your signer available and unlocked, with the identity you intend to use. It must support the NIP-46 connection method offered here. You do not need to paste your private key into the extension for this flow.

Connect by scanning the QR code

  1. Open the extension popup and select Nostr Connect from the setup methods.
  2. Keep the QR Code tab selected. Wait for the code to appear and the Waiting for connection... status.
  3. In your signer, open its connection or QR-scanning function and scan the code displayed by this extension. Use the signer's instructions if its controls have different names.
  4. Review the connection request in your signer, confirm the intended identity and approve it there.
  5. Wait for the extension to recognize the connection and advance. Set or unlock the local vault when prompted, then finish setup and check that the displayed public key matches your signer identity.

If scanning is not available

Copy URI provides the same connection request for a signer that supports opening a Nostr Connect URI. If your signer supplies a bunker:// connection address instead, use the separate Bunker URL tab. Choose the tab that matches the connection method supported by your signer.

If the connection expires

Keep the signer available and check its pending requests. If the extension displays a timeout or failure, select Try again and scan the fresh code. An old screenshot is not a reusable recovery backup.

Keep your signer and its own recovery backup accessible. An extension vault password cannot recover a private key held by an external signer.

Compare all four setup methods, or learn how to review site permissions.

QR Code and Bunker URL are separate tabs, with space before their content. Switch to Bunker URL to paste the connection supplied by your signer. Never paste an nsec or recovery phrase into that field.

Stay Updated

Get news about published Nostr WoT releases, new features, and integrations.

You will receive the newsletter in English.

We store your email address and preferred language to send you the newsletter.

Newsletters