Raspberry Pi Zero
The big computer that fits in your hand
Alby Hub on a Raspberry Pi Zero is surprisingly powerful! 😊 We've seen it handle 100 payments in just 30 seconds without any issues. Truly impressive! ⚡
In this guide, you are going to build a super small lightning network node using the cheapest (but strong) hardware that can be purchased by almost anyone. ⚡
This guide is intentend for Raspberry Pi Zero models ONLY. Other Raspberry pi architectures will not work and there will be problems. At the moment If you want to run on arch64 it is recommended at the moment to use the docker setup.
⚠️ Warning
This guide and the installation of Alby Hub on this device are experimental. This means we may encounter bugs that cannot be easily or quickly resolved.
If you still want to try this guide, please ensure you have a backup of your Alby Hub unlock password. Additionally, one of the first steps upon accessing the hub should be to backup your 12-word keys.
Intro and requirements
Before we begin, you are going to need the following things:
A windows or mac or linux computer
Raspberry Pi Zero 2W (you can use other Raspberry pi models!)
Mobile phone charger wih miniUSB connection (to charge the Raspberry pi Zero 2W)
SD memory card (at least 32gb)
Adapter SD card to USB (to plug it on your computer and download the OS)
Installation
1. Install RPI imager on your computer. 🖥️
Run it and choose "Raspberry Pi Zero 2W" as the device.
2. In "Operating System" choose: "Other -> RASPBERRY PI OS LITE (32-BIT)" as the image
3. Insert the SD card to your computer. 💾
Choose the SD card you just inserted as the storage device in the RPI Imager.
4. Click on Next and then choose to "Edit Settings" and apply OS customisation settings
5. In OS Customization, we are going to check and modify settings on "General" and "Services." ⚙️
On "General," set the hostname as "albyhub.local" (the .local is already set, just write "albyhub").
Set "albyhub" as the username, and choose a strong password.
For wireless LAN, enter the name of your Wi-Fi network as SSID and enter its password.
On "Services," enable SSH.
6. Write the image (Be aware: everything on that SD card will be erased by the RPI Imager) 🚀
7. Once it is finished, ignore the Windows warnings. Remove the SD card from your computer. 💻
8. Place the SD card into the Raspberry Pi Zero and plug it into a power connection. 🔌
The Raspberry Pi Zero will turn on automatically as soon as you plug it in. If it is the Raspberry Pi Zero 2W, a mobile phone charger with a micro USB connection will suffice.
The Raspberry Pi Zero will automatically install the content of the SD card, but we won't see anything. We will need to wait for 5 minutes. Meanwhile, you can open a Terminal (Windows, Mac, or Linux terminal—they all work). Terminals won't sting you 🐝. You won't have to write anything; just copy and paste.
9. a (OPTIONAL) You can verify your Raspberry Pi Zero is ready to work by executing this command in your local terminal. ✅🖥️
If you see a ping result as shown in the image below, you can continue to step 9.b.
9.b Copy and paste the following command into your terminal, then hit "Enter."
You will be asked to type the word "yes"; type it. Then, you will be asked to enter your password. Enter the password you chose in step 5 for the username "albyhub."
10. Waiting period: The terminal will be working. You have to wait. ⏳
Once the terminal has finished and a message appears saying "Installation finished, please visit http://albyhub.local," don't go or click yet. Wait another 5 minutes (it won't work immediately, so just wait a little bit longer).
11. You should now be able to visit http://albyhub.local in your browser. 🌐
Congratulations! 🎉
Your Alby hub is now running on a device that fits in your hand. How awesome is that? 👏
Alby hub initial configurations for self-mounts ⚙️🔧
After setting up your password (choose a good one), we need to OAuth with your Alby web account.
This is a self-hosted, self-mounted sovereign micro node, so... "Why do I have to connect with an Alby web account?" For the moment we did not have enough time to separate this build from the Alby Cloud offering. OAuth with our Alby web accounts will be completely optional in the future.
Finally, our self-hosted, self-mounted Alby hub is ready. 🚀🎉
If you are not sure what to do now that everything is up and running, please go to the initial setup of your Alby hub and wallet. There, you will open your first channel and also make an NWC connection to a wallet interface.
3D Printed Casing
One of our users, Rapax00, made a special 3D printed casing for the Raspy Zero 2W. The design is Also Open Source, feel free to download it, copy it, modify it and use it for your own Raspy Zero 2W Alby 🥰
Maintenance section
Thank you for stopping by! This section was created with contributions from Roland, Moritz & Jean-Paul
Last updated
