Documentation
Documentation
Alby Hub is the open-source, self-custodial Lightning wallet that puts you in control. Connect to your LND or to an integrated node, it’s more than just a wallet—it’s your gateway to Bitcoin. Manage channels, run apps, and take charge of your funds, all through one sleek, user-friendly interface. Empower your Bitcoin journey with simplicity and sovereignty.
LND already on your server: This option tells Alby Hub to use the LND node installed on this StartOS server. It is the more sovereign and secure option, allowing full control over your node.
Alby Hub embedded light node: This option tells Alby Hub to use its own, built-in LDK light node. This option is convenient but offers less control over your node.
Once you’ve made your decision on how to use Alby Hub, install it from the marketplace.
Click Configure
And select your prefered usage type…
Hit Save and then start the service.
You will be running Alby Hub on your server, and it will be connecting to LND on your server.
Launch the Alby Hub UI for the first time.
Cycle through the introduction to arrive at the setup screen.
Click on the Get Started (LND) button.
Enter a password and keep it somewhere safe, like in your personal Vaultwarden instance.
Select whether you will create an Alby account now or later (i.e. not at all).
Note
An Alby Account gives your hub a lightning address, Nostr address and zaps, email notifications, fiat topups, priority support, automatic channel backups, access to podcasting apps & more. If you choose not to create an account, your setup will be complete.
Connect your Alby account by clicking to request an authorization code. This will open a new tab.
If you have a pre-existing Alby account your can log in here, otherwise you can sign up.
You will get an authorization code to add back into the previous tab hosted on your server. Paste that auth code and hit Submit.
Your self-hosted Alby Hub is ready and connected to your self-hosted LND!
You will be running Alb Hub on your server, and it will be connecting to LDK light node on your server. (The Alby Hub service will have a self-contained node, rather than connecting to an external instance of the LND servic. Keep this in mind when considering backups!)
Launch the Alby Hub UI for the first time.
Cycle through the introduction to arrive at the setup screen.
Click on the Get Started (LDK) button.
Enter a password and keep it somewhere safe, like in your personal Vaultwarden.
Select whether you will create an Alby account now or later (i.e. not at all).
Note
An Alby Account gives your hub a lightning address, Nostr address and zaps, email notifications, fiat topups, priority support, automatic channel backups, access to podcasting apps & more. If you choose not to create an account, your setup will be complete.
Connect your Alby account by clicking to request an authorization code. This will open a new tab.
If you have a pre-existing Alby account your can log in here, otherwise you can sign up.
You will get an authorization code to add back into the previous tab hosted on your server. Paste that auth code and hit Submit.
Your self-hosted Alby Hub is ready and connected to your self-hosted LDK light node!
Two of the more important apps you may want to install are:
Alby Web (a simple wallet interface that connects to your Alby Hub and can be saved as a PWA (app-like) on your phone)
Alby Extension (companion for accessing Bitcoin and Nostr apps, payments across the globe and passwordless logins)
If you have connected your Alby Hub to an Alby account during setup, Alby Web will appear connected by default. (If you have not, you can go to Settings > Alby Account to add an account).
This wallet interface allows you to interact with your Alby Hub-connected LND over clearnet with a easy to use interface.
Visit the App Store from your Alby Hub.
Click Connect.
Give the connection to your Alby Extenions a name and decide what access and limitations you give it.
Note
The settings are fairly self explanatory. Typically you’ll want your browser extension to be able to have full access to your lightning node and funds since you will be the only one using it and will want to both make and receive payments. Payments you make have to be confirmed and authorized through the extension, but if you are worried about overspending, the advanced Budget option sets monthly limits on how much can be spent. This is useful in case you get carried away zapping or if you ever misread a payment request that’s higher than you expect.
Download the extension for your browser if you don’t have it already. Install it. Open it if you do already have it installed.
If the extenstion is installed on the same browser, click the newly appeared icon in the menu bar while on the screen above. Click to connect.
You can now spend sats and generate invoices from your browser! Test it out by running your own noStrudel instance.
Alby have extensive users guides available here. Learn how to connect other apps and use the advanced features available to those who set up Alby accounts.
BTC Sessions has created an Alby Hub tutorial here. While this focuses on the cloud hosted variety of Alby Hub, the interface and features are the same, and the Start9 hosted variety gets a mention in the last segment.