🆙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. 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! 💪

The current version of your Alby Hub is indicated in the top left corner of the app. The latest release is published on GitHub.

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/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.✨

Pro Cloud

Updating your Hub with Pro 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, 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

Windows

Updating Alby Hub on Windows

macOS

Updating Alby Hub on macOS

Ubuntu

Coming soon

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

💡 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:

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.

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

🚀 Try Alby Hub on Alby Cloud Today!

If you haven't tried it yet, experience the seamless performance of Alby Hub mounted on Alby Cloud. Don't miss out on optimizing your Alby Hub experience!

🌟 Stay with Us! Get an Alby Account for Free!

Did you know that Alby Hub works even better with an Alby account? By getting an Alby account, you'll receive a free Lightning address and access to enhanced features. Get your Alby account now!

🤝 Open Source software always welcome your help!

Explore Open Source Guides - How to Update Open Source Software for valuable resources on keeping your open-source projects up to date. Stay informed and contribute to our community!

---

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