How to use Fly.io to run Alby Hub

This guide describes the steps to host your Alby Hub on Fly.io

At Alby we are giving you the possibility to connect your own bitcoin lightning node to your Alby Account. To make it easier to run the node we are using a service to decouple the signing of the transactions from the node. This guide explains how you can self-host the signer app to send and receive payments in a sovereign way. Your lightning node will be independently deployed by Greenlight.

Step 1: Create an account on Fly.io and add your credit card details (for free).

Fly.io offers a free tier which just provides enough compute resources to host your signer app for your own lightning node. Your card won't be charged as long as you only use your account to host the app.

Step 2: Install the flyctl

Have a look at this page for Windows, macOS and Linux

Step 3: Sign into your fly account via the CLI

To sign in, run

fly auth login

When your browser opens to the Fly.io sign-in screen, enter your user name and password to sign in.

Step 4: Save the config file

Change the name 'Alby-nwc' to a custom name. For example: 'I-run-AlbyHub'

# fly.toml app configuration file generated for nwc

app = 'Alby-nwc'
primary_region = 'lax'
swap_size_mb = 2048

[build]
  image = 'ghcr.io/getalby/nostr-wallet-connect-next:latest'

[env]
  DATABASE_URI = '/data/nwc.db'
  WORK_DIR = '/data'

[[mounts]]
  source = 'nwc_data'
  destination = '/data'
  initial_size = '1'

[http_service]
  internal_port = 8080
  force_https = true
  auto_stop_machines = false
  auto_start_machines = true
  min_machines_running = 0
  processes = ['app']

[[vm]]
  cpu_kind = 'shared'
  cpus = 1
  memory_mb = '512mb'

Step 5: Launch the app

To launch the signer app, run

fly launch

Make sure you run this command in the directory where you store the config file.

The cli might ask you: Would you like to copy its configuration to the new app? Yes Do you want to tweak these settings before proceeding? No Create .dockerignore from 1 .gitignore files? No

If you see: Watch your deployment at https://fly.io/apps/....the app has been deployed successfully.

Step 6: Access the app

Log into your Fly.io account and you see the new app in the 'Apps' view.

Click on the app to access it on your browser.

Step 7: Setup the app

Select the preferred wallet implementation

Step 9: Open a payment channel to connect your node to the bitcoin lightning network to send and receive instant payments.

Step 8: Connect the app to your Alby account

Now you can connect your self-hosted Alby Hub to your Alby Account:

• Get an Alby lightning address

• Conveniently access one of many apps out there through the Alby Extension or native connections

Step 9: Connect your Alby Hub to many other apps

Congrats you successfully deployed and set up your own lightning node. 🚀