Use your own domain as lightning address

How to use your Alby lightning address with own domain?

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.

Prerequisites

• An active Alby Account with a lightning address (can be free or paid)

• Your own domain with web hosting access

• Ability to upload files to your domain's root directory

Steps

1. Get your Alby lightning address configuration

• Open your browser and go to https://getalby.com/.well-known/lnurlp/YOUR_ALBY_USERNAME

• Replace YOUR_ALBY_USERNAME with your acrtual Alby username

• Save the page (Ctrl+S or Cmd+S) to download the JSON configuration file

2. Prepare the configuration file

• Remove the file extension from the downloaded file (e.g. json)

• Example: If you want [email protected] rename the file to just payments (no extension)

3. Verify the configuration content

Your file should contain JSON similar to this

Example

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

4. Upload to your own domain

• Upload the file to your domain's root directory at this specific path https://yourdomain.com/.well-known/lnurlp/FILENAME

• Important: Your domain must be accessible without www (hosted on the root domain)

5. Example setup

Let's say you want to create [email protected]

• Download the configuration from: https://getalby.com/.well-known/lnurlp/alice

• Rename the file to payments (no extension)

• Upload to https://example.com/.well-known/lnurlp/payments

6. Test your setup

• Check the URL: Open https://yourdomain.com/.well-known/lnurlp/FILENAME in your browser

• Test a payment: Try sending a small payment to your new lightning address

• Verify receipt: Confirm the payment arrives in your wallet

Troubleshooting

• 404 Error: Check that the file is uploaded to the correct .well-known/lnurlp/ directory

• Payment fails: Verify the "callback" URL in your JSON file matches your Alby username

• Domain issues: Ensure your domain works without www prefix

✅ That's it. You just turned your own domain into a lightning address! 🙌