diff --git a/lib/constants.js b/lib/constants.js index 31b4274f..0b17877c 100644 --- a/lib/constants.js +++ b/lib/constants.js @@ -184,8 +184,8 @@ export const LOST_BLURBS = { export const ADMIN_ITEMS = [ // FAQ, old privacy policy, changelog, content guidelines, tos, new privacy policy, copyright policy 349, 76894, 78763, 81862, 338393, 338369, 338453, - // LNbits guide - 1212223 + // wallet guides: LNbits, Alby Hub + 1212223, 1215565 ] export const INVOICE_RETENTION_DAYS = 7 diff --git a/wallets/lib/protocols/docs/user/albyhub.md b/wallets/lib/protocols/docs/user/albyhub.md new file mode 100644 index 00000000..c08c9b14 --- /dev/null +++ b/wallets/lib/protocols/docs/user/albyhub.md @@ -0,0 +1,137 @@ +--- +title: Official Alby Hub Guide +id: 1215565 +sub: meta +--- + +# Official Alby Hub Guide + +last updated: September 10, 2025 + +Flavors: + +- [Desktop](#setup-alby-hub-desktop) +- [Server](#setup-alby-hub-server) + +--- + +## Setup Alby Hub Desktop + +1. Download the latest **Alby Hub Desktop** release from Github [here](https://github.com/getAlby/hub/releases) +2. Run Alby Hub Desktop + +It is recommended to use an **always-on device**, as receiving payments could otherwise fail. + +see [official documentation](https://guides.getalby.com/user-guide/alby-hub/alby-hub-flavors/desktop) + +Now you can attach [**send**](#attach-send) and/or [**receive**](#attach-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](#quickstart) (only Linux) +- [Docker](#docker) +- [Manual](#manual) + +#### Quickstart + +1. Follow the Quick start script provided by Alby [here](https://github.com/getAlby/hub?tab=readme-ov-file#from-the-release) +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: + +```bash +$ docker run -v .albyhub-data:/data -e WORK_DIR='/data' -p 8080:8080 ghcr.io/getalby/hub:latest +``` + +2. 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](https://github.com/getAlby/hub/releases) +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` + +```bash +WORK_DIR="dir/to/albyhub/data" LDK_GOSSIP_SOURCE="" dir/to/albyhub/bin/albyhub +``` + +5. Now you can either [install it as a service](#install-as-a-systemd-service-optional) or run it via `./start.sh` +6. Visit the Web UI at `ip:8080` or `ip:PORT` (if installed as a service) to continue setup + +Now you can attach [**send**](#attach-send) and/or [**receive**](#attach-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](https://nathangrigg.com/2012/07/schedule-jobs-using-launchd/) to mirror what we're going to do here. + +1. Open with your editor of choice `/etc/systemd/system/albyhub.service` +2. Populate: + +```ini +[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 +``` + +3. `sudo systemctl enable albyhub` +4. `sudo systemctl start albyhub` + +--- + +## Attach send + +1. Navigate to the **Connections** tab in Alby Hub +2. Press **Add connection** + +![](https://m.stacker.news/107542) + +3. Create a **Full Access** connection and press Next + +![](https://m.stacker.news/107545) + +4. **Copy** the Nostr Wallet Connect URL via the apposited button + +![](https://m.stacker.news/107543) + +5. **Paste** the copied NWC URL in the NWC send step of the Alby Hub wallet attachment on SN +6. Press **next** in **Stacker News** + +## Attach receive + +1. Navigate to the **Connections** tab in Alby Hub +2. Press **Add connection** + +![](https://m.stacker.news/107542) + +3. Create a **Read Only** connection and press Next + +![](https://m.stacker.news/107544) + +4. **Copy** the Nostr Wallet Connect URL via the apposited button + +![](https://m.stacker.news/107543) + +5. **Paste** the copied NWC URL in the NWC receive step of the Alby Hub wallet attachment on SN +6. Press **next** in **Stacker News** diff --git a/wallets/lib/wallets.json b/wallets/lib/wallets.json index 3c79af5c..9752c34f 100644 --- a/wallets/lib/wallets.json +++ b/wallets/lib/wallets.json @@ -118,7 +118,8 @@ "name": "ALBY", "displayName": "Alby", "image": "/wallets/alby.svg", - "url": "https://getalby.com/" + "url": "https://getalby.com/", + "guide": "/items/1215565" }, { "name": "BLIXT",