- Linux distribution
- Runs pretty much on any VPS/server with 512MB RAM or more (1GB recommended / plus some swap space ideally)
- lightning port 9735 must be available
We have prepared an installation script that installs Alby Hub for you. We recommend inspecting the install script and if needed adjusting it or taking inspiration from it for your setup.
If you do a fresh server setup make sure to do the basic setup like for example creating a new user and configuring the firewall. Here is a simple tutorial for this.
Run the installation script on your server:
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/getAlby/hub/master/scripts/linux-aarch64/install.sh)"
The install script will prompt you for an installation folder and will install Alby Hub. Optionally it can also create a systemd service for you.
You can also do these quite simple steps manually, have a look in the install script for details.
Alby Hub will run on localhost:8080 (standalone) or localhost:8029 (when run with a systemd service) configurable using the PORT environment variable or by editing Environment="PORT=8029" in the albyhub.service systemd config file - See "Editing The Service" below)
To run on a public domain we recommend the use of a reverse proxy using Caddy
Either use systemd:
$ sudo systemctl [start|stop] albyhub.service
Or use the start scripts:
$ [your install path]/start.sh
$ sudo journalctl -u albyhub
$ sudo nano /etc/systemd/system/albyhub.service
$ sudo systemctl daemon-reload
$ sudo systemctl restart albyhub.service
Make sure to backup your data directories:
[your install path]/data
The install script will add an update.sh script to update Alby Hub. It will download the latest version for you.
After the update you will have to unlock Alby Hub again.
Alby Hub comes as docker image: ghcr.io/getalby/hub:latest
$ docker run -v .albyhub-data:/data -e WORK_DIR='/data' -p 8080:8080 ghcr.io/getalby/hub:latest`
We also provide a simple docker-compose file:
$ wget https://raw.githubusercontent.com/getAlby/hub/master/docker-compose.yml # <- make sure to update platform
$ mkdir ./albyhub-data
$ docker-compose up # or docker-compose up --pull=always <- to make sure you get the latest images
Make sure to mount and backup the data working directory.