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 . 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 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/hub:latest'

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

[[mounts]]
  source = 'nwc_data'
  destination = '/data'
  initial_size = '1'
  auto_extend_size_threshold = 80
  auto_extend_size_increment = "1GB"
  auto_extend_size_limit = "5GB"

[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 = '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: Set up Alby Hub

Click on "Get Started"

How to update Alby Hub on Fly.io

In Powershell on Windows, navigate to the directory of your fly.toml with cd [directory path]. Then type fly deploy in Powershell. You'll see further information printed in Powershell.

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

Last updated 6 months ago

Was this helpful?

# fly.toml app configuration file generated for nwc app = 'Alby-nwc' primary_region = 'lax' swap_size_mb = 2048 [build] image = 'ghcr.io/getalby/hub:latest' [env] DATABASE_URI = '/data/nwc.db' WORK_DIR = '/data' [[mounts]] source = 'nwc_data' destination = '/data' initial_size = '1' auto_extend_size_threshold = 80 auto_extend_size_increment = "1GB" auto_extend_size_limit = "5GB" [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 = '512mb'