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
  • Install Alby Hub on:
  • Windows đŸ’ģ
  • macOS 🍏
  • Linux 🐧
  • All systems đŸ–Ĩī¸đŸ–ąī¸
  • 1. Select your operating system below
  • 2. Extract the zip file
  • 3. Find the Alby Hub file in the extracted order and install it.

Was this helpful?

  1. Alby Hub
  2. Alby Hub flavors

Desktop

You can run Alby Hub on your own computer, whether it is running on Windows, MacOS, or Linux.

Last updated 1 month ago

Was this helpful?

Install Alby Hub on:

1. 2. 3. 4.

Alby Hub for desktop is well-suited for self-hosting for users who have a basic understanding of software configuration and network settings, and have their computers online 24/7 in order to send or receive payments. Therefore, consider this option if you keep the desktop computer always online.

😄 For a reliable 24/7 payment service we recommend you to subscribe for and have your self-custodial wallet online in the cloud. đŸ‘â˜ī¸đŸ


Windows đŸ’ģ


macOS 🍏


Linux 🐧

Installing on Linux for advanced users
Linux Troubleshooting: Common Errors
  • Ubuntu 22.04 Crash on Startup: If AlbyHub crashes on startup, try running sudo apt-get install libwebkit2gtk-4.0-37. This resolves a known issue with missing dependencies.

  • Blank White Screen with Graphics Acceleration: If after installing the necessary libraries, AlbyHub still shows a blank white screen, launch the app with the command export WEBKIT_DISABLE_DMABUF_RENDERER=1 to disable the problematic renderer.

  • Server Version Recommendation: For users experiencing persistent issues, we recommend using the server version of AlbyHub. It lacks a GUI, making it less prone to graphical errors.


All systems đŸ–Ĩī¸đŸ–ąī¸

1. Select your operating system below

The download of Alby Hub app files starts automatically.

2. Extract the zip file

This can vary slightly amongst systems.

3. Find the Alby Hub file in the extracted order and install it.

In none of the cases the files are installed as a system startup process. You have to open the file manually or add it to the system startup if you want it to run permanently each time you restart your computer.

Congrats! 🎉 Your Alby hub is now running on your desktop. 👏 Remember, keeping your Alby Hub online is crucial for seamless payment processing. 🕙


Thank you for stopping by! This section was created with contributions from Tomek, Roland, Moritz & Jean-Paul

Click to get started.

🍕
here

đŸ’ģ Windows

🍏 MacOS

🐧 Linux

đŸ’ģ Consider Switching to Pro Cloud!

If you can't guarantee that your computer will always be online, consider switching to Alby's cloud server before depositing funds. This ensures that your node remains active and your transactions seamless.

🌟 Verify Our Open Source Code!

All our software is open source, meaning you can verify its integrity and security. Check out our code on GitHub and see how we build transparency and trust with our users.

🔄 Don't Forget to Update Your Alby Hub!

Keeping your Alby Hub updated is crucial for security and performance. Don't miss out on new features and improvements, ensure your hub is always running the latest version.

Pro Cloud
Windows
macOS
Linux
Instruction for All Systems and Download links