Alby User Guide
Developer GuideUser Dashboard
🐝 Alby Hub, Browser Extension and Account
🐝 Alby Hub, Browser Extension and Account
  • 🏠 Hub, Browser Extension, Account
  • Alby Go
    • 📲Get Alby mobile app
    • 👩‍🚀Send, Receive, Go!
  • Alby Hub
    • â„šī¸Introduction
    • đŸšĸGetting Started
    • 🍕Alby Hub flavors
      • Alby Pro Cloud
      • Other Cloud Options
      • Desktop
      • Docker
      • Umbrel, Start9, etc
      • 🐧Linux
      • 🆙Updating
    • 👛Wallet
      • đŸ’ĢOpen your first channel
      • 📤Send
      • đŸ“ĨReceive
      • âŦ†ī¸Buy Bitcoin
        • 💰Withdraw from an exchange
      • âŦ‡ī¸Sell Bitcoin
    • 🔗App Connections
    • 🎮App Store
      • 🏡Sub-wallet, Friends & Family
        • Fast sub-wallets (no lightning address)
        • Sub-wallet with lightning address âšĄī¸
        • Podcaster & musicians sub-wallets
        • ❓Q&A of sub-wallets
      • 📅ZapPlanner
    • 🚰Node
      • đŸ“ĨIncrease receiving capacity
      • 📤Advanced: Increase Spending Balance with on-chain bitcoin
      • â¤ī¸Node Health
      • 💰On-chain Balance
      • Swap In & Out
    • 🔐Backups & Recover
    • ❓FAQ Alby Hub
      • How can I access Alby Hub from my phone?
      • Why do I need to link my Alby Account?
      • Should I open a private or public channel?
      • How can I change routing fees?
      • How can I close a channel? What happens to the sats in this channel?
      • Why was my lightning channel closed and what to do next?
      • How can I update my Alby Hub?
      • How can I change my unlock password?
      • How can I check budgets of connected apps?
      • How can I backup my keys
      • Where is Alby Hub physically located?
      • How can I migrate Alby Hub to a different machine?
      • How to use Fly.io to run Alby Hub
      • What to do during times of high onchain fees?
      • What to do if I cannot send a payment?
      • What to do if I cannot receive a payment
      • Should I open multiple channels with the same counterparty?
      • What happens if the healthcheck indicator turns red?
    • 📚Bitcoin Wallet Glossary
  • Alby Browser Extension
    • 👾Features
      • đŸ’ŗManage multiple wallets
      • đŸ’ĩCreate and change budgets
      • 🔂Send and receive bitcoin
      • đŸĨManage site connections
      • đŸ—ī¸Master Key
      • đŸĻ¤Nostr
      • 🌊Liquid
      • âš–ī¸HOLD Payments
    • 🔗Link wallet
      • Alby web Account
      • Umbrel
      • Alby Hub via NWC link
      • LND
      • No limits - quick & easy
    • 🎮Discover apps
    • 🐞Debugging
      • Connecting your LN node
      • Google Chrome
      • Mozilla Firefox
      • Using nightly builds
    • ❓FAQs Alby Extension
      • How do I install the Alby Browser Extension?
      • Why do I need a unlock password?
      • Can I trust the software?
      • Lost Password
      • Does the extension work on Mobile?
      • Implementing payments and authentication
      • Can I use Alby with the Tor Browser?
      • What is the Alby Companion App?
      • How to enable Alby only on specific websites?
      • Can I connect LND with readonly permissions?
      • How to use Alby with nosft.xyz to get NFT ordinals/inscriptions?
      • How to access my old account in apps with the Alby Extension
      • What permission does the extension require?
      • How can I run my own Lightning node?
      • Migrate from old LNDHub setup
      • I lost my Nostr ID when making a new account
  • Alby Account
    • â„šī¸Introduction
    • 🔗Link wallet
      • 🔗Link Alby Hub
      • 🔗Link other NWC wallet
    • 🌮Features
      • Nostr identifier
      • Lightning Address
      • Notifications and reports
      • Email, Password, Currency
      • âŦ†ī¸Top up your wallet
        • Card or bank transfer
        • Exchange service
        • Other bitcoin wallet
        • Other crypto wallet
      • âŦ‡ī¸Convert to fiat
    • 🎮Connect to apps
      • NWC Connections
      • Alby Browser Extension
      • BTCPay Server
      • Podcast apps
      • Alby Go mobile app
    • 👩‍đŸ’ģUse your lightning address
      • Nostr
      • Own domain
    • ❓FAQs Alby Account
      • Alby Hub is here! What happens to my existing balance?
      • Are there transaction limits with my Alby Account?
      • Can I open a channel to Alby's lightning node?
      • How to increase your weekly payment volume?
      • Why is there a minimum balance required?
      • Which service fees apply for using an Alby account?
      • How does Alby make money?
      • How to use Fly.io to run Alby Hub
      • What are fee credits in my Alby account
      • Embrace Alby Hub - phasing out Alby’s shared wallet
Powered by GitBook
LogoLogo

Our content

  • Website
  • Blog
  • GitHub

Follow us

  • Nostr
  • Twitter / X
  • Youtube

Contact us

  • E-mail
  • Community Chat
  • Open Hours

Your bitcoin & nostr companion / from 🐝 with 🧡

On this page

Was this helpful?

  1. Alby Account
  2. Use your lightning address

Own domain

Alby allows you to use your lightning addresses with custom domains. This is how you do it.

Last updated 9 months ago

Was this helpful?

Please read and fill out the form first. To use your own domain, you will need to upload a file to the server of your own domain. We need a way to contact and inform you, if the file requires a change. For advanced users, we recommend setting up a redirect rather than hosting a copy of your lightning address data.

1ī¸âƒŖ Setup your @getalby.com lightning address

Sign up for your Alby account and choose a .

2ī¸âƒŖ Find your LNURL

Open https://getalby.com/.well-known/lnurlp/<username> in your browser and save this document to your local computer. (CTRL+S) Remove the filename extension (e.g. json) from the file.

Your username is the part before the @ in your lightning address: username@getalby.com

You should now have a file named <username> (no file extension) and with contents similar to this one:

Example
{
   "status":"OK",
   "tag":"payRequest",
   "commentAllowed":255,
   "callback":"https://getalby.com/lnurlp/hello/callback",
   "metadata":"[[\"text/identifier\",\"hello@getalby.com\"],[\"text/plain\",\"Sats for Alby\"]]",
   "minSendable":1000,
   "maxSendable":11000000000,
   "payerData":{
      "name":{
         "mandatory":false
      },
      "email":{
         "mandatory":false
      }
   },
   "nostrPubkey":"79f00d3f5a19ec806189fcab03c1be4ff81d18ee4f653c88fac41fe03570f432",
   "allowsNostr":true
}

Please, do not change the content of that file!

3ī¸âƒŖ Upload the file to your website

Your hostname must be hosted on the root domain (no www).

Upload the file from the step before to this location:

https://<your_domain>/.well-known/lnurlp/<your_username>

Make sure the .well-known/lnurlp folder is created within the publicly accessible root on your server (such as "www" or "public-html"). This depends on what server you use.

Example

You want to setup me@example.com as your lightning address. Upload the file to your webhost so it's available via this URL:

https://example.com/.well-known/lnurlp/me

You should be able to open this URL in your browser. Try to send a payment to your newly created lightning address to test if everything works.

✅ That's it. You just set up a custom lightning address! 🙌

if you need help.

👩‍đŸ’ģ
Contact us
lightning address