An everyday payment between two phones at a café, editorial illustration
Lightning / GUIDE

Alby Hub: your own Lightning node, connected to your apps

Alby Hub runs a self-custodial Lightning node that apps, your phone and AI agents can connect to with spending limits. Where to run it, your first channel, the App Store, sub-wallets, AI agents and MCP, backups, and what Alby sees.

Start reading
12 min readEnglish
READING MODE

What Alby Hub is

Alby Hub is a Lightning wallet that runs your own Lightning node. You hold the keys, you open the channels, and the node sends and receives payments for you. Its main trick is connecting to other apps. A podcast app, a Nostr client or your phone can each get their own connection to the wallet, with a spending limit you set.

Underneath, it runs an LDK Lightning node by default. It can also sit on top of a node you already run, such as LND or Core Lightning. Alby, the company behind the Alby browser extension, makes it. The code is published under the Apache 2.0 licence. This guide was checked against version 1.24.7, released on 14 November 2026.

Alby's own setup screen says: "Alby Hub is a spending wallet - do not keep all your savings on it!" The node holds its keys on a machine that is always online, so treat it as a wallet for spending and keep savings in cold storage.

Alby Hub source code ↗ · Alby Hub 1.24.7 release ↗

Where to run it

A Lightning node has to be online to receive payments, so pick a machine that stays on.

  • Your home node. Alby Hub is an app on Umbrel and Start9, and on RaspiBlitz, MyNode and others. On Umbrel it can run its own node or use Umbrel's Lightning app.
  • A server you rent. Alby's guides cover setting it up on cloud providers such as DigitalOcean, Hetzner, Fly.io and Render, in your own account. It needs about 2 GB of memory.
  • Your computer. There is a desktop app for macOS, Windows and Linux. Alby's guides say it only suits a computer that is always online.

Alby used to host Hubs for a monthly fee under the name Alby Cloud. Its pricing page no longer lists that plan.

Whichever you choose, the keys are on that machine. Alby Hub encrypts them with your unlock password, but the running node has to decrypt them to work. Whoever controls the machine controls the wallet. On a rented server that includes the hosting company. Never open Alby Hub's web page to the whole internet. Alby's documentation advises a VPN or a restricted connection.

Alby: ways to run Alby Hub ↗

Set up

  1. Open Alby Hub and choose Get Started.
  2. It offers to connect an Alby Account. This is optional. Choose Connect or Maybe later. What the account adds is covered below.
  3. Choose a password and tick both boxes, I've secured this password in a safe place and I understand this password cannot be recovered. Alby cannot reset it.
  4. Read the Security & Recovery screen, tick I understand how to secure and recover funds and choose Continue.
  5. Go straight to Settings, then Backup. Enter your password and choose View Recovery Phrase. Write the 12 words on paper.

Setup does not show you the recovery words, so the last step is easy to miss. The home screen's checklist includes Backup your keys as a reminder.

Welcome to Alby Hub

A powerful, all-in-one bitcoin lightning wallet with the superpower of connecting to applications.

Get StartedAdvanced Setup
1 / 4
Illustration of setting up Alby Hub and finding the recovery phrase, drawn from Alby Hub's own wording in version 1.24.7. Not a screenshot; layout and colours are simplified, and the optional Alby Account step is left out.

Receiving your first payment

A new Lightning node has no channels, so it cannot receive anything yet. Alby Hub has three ways to get the first one.

  • Just receive. This is the default. Create an invoice and send yourself a payment. A Lightning service provider opens a channel to you as the payment arrives and takes its fee out of it. The invoice shows the fee, and there is a minimum amount for the first payment. Alby Hub's code refuses a fee above 5,000 sats or 10% of the payment, whichever is larger.
  • Buy a channel. Open Your First Channel buys a channel from one of the providers Alby lists: Megalith, Lnserver, Olympus by ZEUS or Magma by Amboss. The price appears as Channel Cost in US dollars, payable in bitcoin or by card. This route needs an Alby Account.
  • Use your own bitcoin. Deposit on-chain bitcoin to the Hub and open a channel with it to a well-connected node. This gives you room to send at once, and room to receive only after you have spent some.

Keep a small on-chain balance as well. Alby Hub sets no reserve on its channels, and its code notes that you should keep some on-chain funds to cover fees if a channel ever closes.

Lightning has more moving parts than an ordinary wallet. Lightning, without the surprises covers channels and liquidity in plain terms.

Alby: just-in-time channels ↗

Connecting apps and your phone

Apps connect through Nostr Wallet Connect, an open standard for giving an app access to a wallet. Under Connections, choose Add Connection, name it and pick what it may do.

  • Full Access sends and receives payments.
  • Read Only receives payments and views your history.
  • Isolated App gets its own separate balance.
  • Custom lets you choose each permission.

Switch on Budget to cap what the app can spend each day, week, month or year, and Expiration to end the connection after a week, a month or a year. Give every app the smallest budget that works. If an app or its server is compromised, the budget is the most it can take.

HomeWalletSub-walletsConnectionsAI & AgentsCardsNodeSettings
ConnectionsAdd Connection
App StoreConnected Apps
1 / 4
Illustration of connecting an app with a monthly budget, drawn from Alby Hub's own wording in version 1.24.7. Not a screenshot; layout and colours are simplified. The app name, budget and expiry are examples.

For your phone, Alby makes Alby Go, a free app for iPhone and Android. It holds no funds itself. It connects to your Hub the same way, by scanning a connection code, and sends and receives through it.

Alby Go source code ↗

The App Store

The App Store tab under Connections lists 56 apps that work with Alby Hub, in groups such as wallet interfaces, social media, merchant tools, payment tools, audio, AI and games. Each one opens a short setup guide. Some examples:

  • Wallet apps. Alby Go and the Alby browser extension, the Alby CLI for the command line, and ZEUS.
  • Nostr and social. Clients such as Damus, Primal and Amethyst, so you can send and receive zaps from your own node.
  • Podcasts and music. Fountain, Wavlake and other players that stream small payments to creators as you listen.
  • Taking payments. BTCPay Server and other checkout tools, which Alby Hub sets up as read-only by default. BuzzPay PoS is a receive-only till you can share with staff, and SimpleBoost is a donation widget for a website. Both get their own separate balance.
  • Spending. Bitrefill for gift cards, ZapPlanner for scheduled payments, and card services such as Bringin and wavecard that let you spend at card terminals. The card services are run by third parties, with their own terms.

Apart from Alby's own, these are third-party apps. The listing is not a recommendation of the service behind each one, and each connection still gets only the permissions and budget you give it.

Alby: the App Store ↗

Sub-wallets

Sub-wallets are separate balances inside your Hub. Alby Hub suggests them for friends, family or coworkers, and Alby suggests one for each AI agent. Each has its own balance and can connect to Alby Go or another app, and you can give it a Lightning address. The free plan allows three, and Pro allows any number.

A sub-wallet is a balance your Hub keeps track of, not a separate node. It spends from your Hub's own Lightning channels, so keep enough there to cover what your sub-wallets hold. As the operator, you can see every sub-wallet's transactions. Alby's documentation says so plainly, and anyone you give one to should know.

Alby: sub-wallets ↗

AI agents and MCP

The AI & Agents page in the sidebar connects an AI assistant to your wallet, so it can pay invoices, create invoices and buy from services that charge in sats. Its heading is "Give your AI agent a wallet".

  • Coding agents and assistants. Under Choose your agent, pick one such as Claude, Cursor, Codex, Gemini CLI, Goose or Cline. Alby Hub gives you a prompt to paste into it. The prompt installs Alby's payments skill, which uses the Alby CLI, and you approve the new connection in your Hub.
  • Claude on the web or desktop. Using Claude Web / Desktop? creates a connection straight away and gives you a web address to add in Claude under Settings, then Connectors, as a custom connector. It points at Alby's hosted MCP server. MCP is the standard way AI assistants connect to outside tools. Alby's MCP README says this needs a paid Claude plan.

Alby's MCP server lets the assistant check the balance, list transactions, create and pay invoices, request an invoice from a Lightning address and convert currency amounts to sats. It can also pay for web resources that charge in sats per request. It is open source and can run on your own computer.

  • The connection can spend. A connection made from this page can send payments, with Alby Hub's default budget of 100,000 sats a month. It draws on your main balance.
  • The address is a key. The connector address contains your connection secret. Anyone who has it can spend up to the budget, and Alby's hosted server receives it every time it is used.
  • Agents make mistakes. An agent can misread a request, or be tricked by something it reads on a web page.

Alby itself suggests giving an agent its own sub-wallet, with "funds isolated from your main wallet". Put in only what you are happy for the agent to spend, lower the budget under Edit budget & permissions, and remove the connection when you stop using it.

HomeWalletSub-walletsConnectionsAI & AgentsCardsNodeSettings
AI & AgentsExplore App Store

AI + Bitcoin

Give your AI agent a wallet

Connect any AI agent to your Alby Hub and let it send payments, buy gift cards, and access paid services on its own.

Stay in Control
Set spending limits per agent. You decide how much it can spend and when budgets reset.
1 / 3
Illustration of connecting an AI agent, drawn from Alby Hub's own wording in version 1.24.7. Not a screenshot; layout and colours are simplified, and the page's examples and featured services are left out. The connector address is shown masked, as the Hub shows it.

Alby MCP server ↗ · Alby: AI agents ↗ · Alby Hub source: AI & Agents page ↗

The Alby Account and Pro

An Alby Account is a free login at getalby.com. Linking it to your Hub gives you a Lightning address in the form name@getalby.com, email notifications, and the option to buy a first channel. It also uploads an encrypted backup of your channels after each new one, which matters for recovery below.

The price is privacy. With the account linked, your transactions appear on your getalby.com dashboard, and the Hub reports events to Alby by default, such as payments sent and received, by payment ID, and channels opening and closing.

Pro costs $3.90 a month. It adds a custom Lightning address, unlimited sub-wallets and live channel backups.

Alby pricing ↗ · Alby: why link your Alby Account ↗

Backups and recovery

Your 12 recovery words bring back your on-chain bitcoin. Money in Lightning channels is different, and what happens to it depends on your setup.

  • With Pro. Alby keeps an end-to-end encrypted copy of your channel state as it changes. You can restore with your recovery words and the same Alby Account, without closing your channels.
  • With a free Alby Account. Alby stores an encrypted channel backup. To recover, Alby's recovery tool asks each channel partner to force-close. Your Lightning balance comes back on-chain within about two weeks, and you need new channels afterwards.
  • With no account. After every new channel, copy the newest file from the Hub's static channel backup folder somewhere safe. Alby warns that channels opened after your last copy could be lost.

Moving to a new machine. Use Settings, then Migrate Alby Hub, to make a migration file. It keeps your channels open. Alby warns that after you create the file, you must not restart the old Hub. Two copies of one node can lose channels. Anyone with the file and your password can take your funds. Migration only works when Alby Hub runs its own node.

Whatever you choose, test it. A recovery rehearsal shows how.

Alby: backups and recovery ↗ · Alby Hub recovery tool ↗

Closing channels and swaps

To move Lightning money back on-chain, close a channel. Normal Close (Recommended) works with your channel partner and usually lands within an hour. Force Close works without them, but Alby Hub warns that your funds may be locked for up to two weeks and fees can be higher. Use it only when a normal close fails. Channel partners can also close channels themselves, for example when your node has been offline or a paid channel's term ends.

Swap moves money between on-chain and Lightning without closing anything. The swaps go through SATS Routing, which charges its own fee, plus on-chain fees. Alby's pricing page says it adds no transaction fees, but Alby Hub's source code adds a 1% Alby fee on every swap. The swap screen shows the total before you confirm.

Privacy

  • Your node looks up the blockchain through Alby by default, using Alby's Electrum server. You can point it at your own node instead.
  • App connections pass through Alby's relays by default. The messages are encrypted.
  • Your channel partners see your payments that route through them, as on any Lightning node.
  • No Tor setting. The source code has no option to route the Hub through Tor.

Alby says it cannot see payments made through your app connections unless your Alby Account is linked.

Before you rely on it

  • The Hub runs on a machine that stays on, and its web page is not open to the internet.
  • Your unlock password is stored safely. It cannot be reset.
  • Your 12 recovery words are on paper.
  • You know which backup you have for your channels, and you have tested a recovery.
  • Every connected app has its own budget, and you have removed the ones you no longer use.
  • Any AI agent has its own sub-wallet or a small budget, never open access to your main balance.
  • Only spending money is in the Hub, with a small on-chain balance for fees.

For simpler Lightning on a phone, without running a node, compare Phoenix. If you already run LND, ZEUS can control it from your phone.

Sources & further reading

Researched 18 November 2026. Software and services change: check the current documents before you act.

Lightning, without the surprises → · Choose the Lightning setup you can maintain → · Phoenix → · ZEUS: ecash, a phone node or your own node → · Umbrel: run a node and connect your wallets to it → · Start9: run a node and connect your wallets to it → · BTCPay Server: take bitcoin payments without a middleman →

Continue your path

One question leads to another.

01Lightning, without the surprises02Choose the Lightning setup you can maintain

Find your next answer.

Search the complete field guide · Esc to close