Updating

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

Last updated 1 month ago

Was this helpful?

Updating

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

Updating Alby Hub on WindoAlby team and open-source contributors are constantly researching and working on Alby Hub to ensure you have the latest features and security improvements. By doing this, you are taking control of your digital tools and enhancing your self-sovereignty. Let's get started! Keep your Alby Hub up to date! 💪

1 . How to Update 2 . Choose your Alby Hub specific flavor 2.1. Alby Cloud 2.2. Desktop 2.3. Docker 2.4. Umbrel/Start9/MyNode 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
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

Important Reminder

There is no recovery email for your password. If you lose it, it cannot be recovered. You are self-sovereign and self-responsible. We do not keep or store any passwords, nor can we recover them. Self-custodial means it is your own private space that only you control. 💪

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 Alby Cloud

Go to getalby.com and go to your Dasboard.
Inside your Alby web account, go to "Wallet Configuration"
Under "Alby Hub", simply click no "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, simply shut down and reboot your instance. This should be sufficient for it to automatically check for and load the latest version. Those instances are using docker images, so if needed you can also updated them manually just like you would for a docker image

Desktop

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.

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

💡 What Does It Mean for Alby to Be an Open Source Company?

Being an open source company means that our software is freely available for anyone to use, modify, and distribute. This fosters transparency, security, and innovation. By offering multiple update and self-hosted options, we empower you with control and flexibility, benefiting both you and the broader community. Open source is good for the world as it promotes collaboration and accelerates technological advancement.

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. Here are the final steps to get everything back up and running After updating:

After Updating

Unlocking your Alby Hub is simple. Follow these steps:

Visit Your Hub URL: Go to the URL of your Alby Hub.
Enter Your Unlock Password: Log in with your unlock password to launch Alby Hub and re-enable your wallet.

Great job on completing the update! You now know how to update your own flavor of Alby Hub and it is ready to use. 🎈

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