🆙Updating

Keep your Alby Hub up to date for the latest and greatest features. Don't worry, it's super easy!

The Alby team and open-source contributors are constantly researching and working on Alby Hub to ensure you have the latest features and security improvements. Let's get started! Keep your Alby Hub up to date! 💪

You'll find the current version of your Alby Hub in the top left corner of the app. All releases are published on GitHub.

Overview

1 . How to Update 2 . Choose your Alby Hub specific flavor 2.1. Pro Cloud 2.2. Desktop 2.3. Docker 2.4. Umbrel, Start9, etc. 2.5. Ubuntu 3 . Congratulations!

---

1. How to Update 🚀

When an Alby Hub update becomes available you'll be notified directly in the Hub. The update process depends on how you run Alby Hub.

Before you Update

Please note the following before you update your hub:

• Make sure you have backed up your Alby Hub recovery phrase consisting of 12 words (for the embedded node option only)

• Make sure you have your Alby Hub password saved

• Update might take a few minutes

• Unlock is required after the update by entering your Alby Hub password

---

2. Choose your Alby Hub specific flavor 🍕

Find the perfect version of Alby Hub that you are running that fits your specific needs and apply its unique update!

It is recommended to do regular updates, as Alby developers are improving it every week.

Alby Cloud

Updating your Hub running on Alby Cloud

1. Go to getalby.com and click "Login".

2. Inside your Alby web account, go to "Wallet Configuration"

3. Click on "Update now".

Other Cloud Options

The currently recommended deployment options on our GitHub repository are Digital Ocean, Render, and Fly. All three load the latest version from the GitHub repository. If your Alby Hub is outdated, shut down and reboot your instance. Those instances are using docker images, so if needed you can also updated them manually just like you would for a docker image.

---

Desktop

Windows

Updating Alby Hub on Windows

macOS

Ubuntu

Updating older Hub versions (<=1.10.2) on macOS

Follow these steps if you have done the above and see two Hubs in your Launchpad

• Close all instances of the Hub

• Open your Terminal and type cd "/System/Volumes/Data/Users/<your-user-name>/Library/Containers" and then do ls

• You should be able to see two folders in the list com.getalby.albyhub and com.getalby.Alby-Hub

• Your old data resides in com.getalby.albyhub, so we should move that to com.getalby.Alby-Hub

• To do that do cd "/System/Volumes/Data/Users/<your-user-name>/Library/Containers/com.getalby.albyhub/Data/Library/Application Support" and then do cp -r albyhub "/System/Volumes/Data/Users/<your-user-name>/Library/Containers/com.getalby.Alby-Hub/Data/Library/Application Support/albyhubold - this should copy the old Hub data to the new one

• Now do cd "/System/Volumes/Data/Users/im-adithya/Library/Containers/com.getalby.Alby-Hub/Data/Library/Application Support" and ls to see if there is albyhubold listed

• Do mv albyhub albyhubempty and then mv albyhubold albyhub

• Close your terminal(s) and run the new Hub again, it should work as normal. Delete the old Hub to avoid confusion

• From the next update, you can follow the regular MacOS guide as usual

---

Docker

Updating Alby Hub running from Docker

When running on docker, these are the steps to run the latest version:

docker pull ghcr.io/getalby/hub:latest

docker stop albyhub

docker rm albyhub

docker run -d --name albyhub \
  -v ~/.local/share/albyhub:/data \
  -e WORK_DIR='/data' \
  -p 8080:8080 \
  ghcr.io/getalby/hub:latest

These commands will run the docker image with the previous data, with no data loss and an updated Alby Hub

---

Umbrel, Start9, etc.

Updating on Umbrel, Start9, etc.

Go to your Node OS app store, check the current version of Alby Hub. If it is outdated, then proceed to make sure you have the latest version available for your Node OS. For Start9: Visit their guide For Umbrel: Click "Check for updates".

---

Ubuntu

Manual installation (Ubuntu)

Go to your terminal and run these commands:

# Update Snap packages
sudo snap refresh go

# Update build-essential
sudo apt update
sudo apt upgrade -y build-essential

# Navigate to the app directory
cd /path/to/your/app # Update this to the actual path where Alby Hub is

# Pull the latest changes from GitHub
git pull origin main

# Update dependencies and rebuild the app
cd frontend
yarn install
yarn build:http
cd ..

# Run the Alby Hub
go run http/alby_http_service.go

---

3. Congratulations! 🎉

Your Alby Hub is Updated and Ready to Go!

You have successfully updated your Alby Hub! However, your Alby Hub will be locked and inaccessible for connected apps. Payments will not work until you unlock your Hub. You need to unlock it after the update:

1. Visit Your Hub URL: Go to the URL of your Alby Hub.

2. Enter Your Unlock Password: Log in with your unlock password to launch Alby Hub and re-enable your wallet.