ekzyis/stacker.news
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
stacker.news/wallets/lib/protocols/docs/user/albyhub.md
soxa cda6d23bb2
Alby Hub guide (#2506) 
* albyhub guide

* add more shortcuts, fix systemd code block

* add link to macOS guide for service installation

* add some formatting and better separation of concerns

* fix headings

* add references to SN

* correct order, new screenshots, in-depth steps
2025-09-10 11:13:46 -05:00

3.6 KiB
Raw Blame History

title id sub
Official Alby Hub Guide 1215565 meta

Official Alby Hub Guide

last updated: September 10, 2025

Flavors:

Setup Alby Hub Desktop

  1. Download the latest Alby Hub Desktop release from Github here
  2. Run Alby Hub Desktop

It is recommended to use an always-on device, as receiving payments could otherwise fail.

see official documentation

Now you can attach send and/or receive

Setup Alby Hub Server

Requirements:

  • a server running a Linux-based distribution or macOS
  • reachable from the internet via clearnet and HTTPS

Choose a path:

Quickstart

  1. Follow the Quick start script provided by Alby here
  2. Visit the Web UI at ip:8080 or ip:8029 (if installed as a service) to continue setup

Docker

  1. Pull the image from Docker:
$ docker run -v .albyhub-data:/data -e WORK_DIR='/data' -p 8080:8080 ghcr.io/getalby/hub:latest
  1. Visit the Web UI at ip:8080 to continue setup

Manual

  1. Download the latest Alby Hub Server release for your processor from Github here
  2. Extract it to a folder of your choice, we'll go with albyhub, and navigate to it
  3. Create a data folder in albyhub: mkdir -p data
  4. Create a start.sh script in albyhub
WORK_DIR="dir/to/albyhub/data" LDK_GOSSIP_SOURCE="" dir/to/albyhub/bin/albyhub
  1. Now you can either install it as a service or run it via ./start.sh
  2. Visit the Web UI at ip:8080 or ip:PORT (if installed as a service) to continue setup

Now you can attach send and/or receive

Install as a systemd service (optional)

This focuses on systemd for Linux systems.

macOS uses launchd to handle services, you can follow this really good guide to mirror what we're going to do here.

  1. Open with your editor of choice /etc/systemd/system/albyhub.service
  2. Populate:
[Unit]
Description=Alby Hub
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
Restart=always
RestartSec=1
User=$USER
ExecStart=dir/to/albyhub/start.sh
Environment="PORT=8029"

[Install]
WantedBy=multi-user.target
  1. sudo systemctl enable albyhub
  2. sudo systemctl start albyhub

Attach send

  1. Navigate to the Connections tab in Alby Hub
  2. Press Add connection

  1. Create a Full Access connection and press Next

  1. Copy the Nostr Wallet Connect URL via the apposited button

  1. Paste the copied NWC URL in the NWC send step of the Alby Hub wallet attachment on SN
  2. Press next in Stacker News

Attach receive

  1. Navigate to the Connections tab in Alby Hub
  2. Press Add connection

  1. Create a Read Only connection and press Next

  1. Copy the Nostr Wallet Connect URL via the apposited button

  1. Paste the copied NWC URL in the NWC receive step of the Alby Hub wallet attachment on SN
  2. Press next in Stacker News