# Updating
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](https://github.com/getAlby/hub).
## Overview
1 . [How to Update](#id-1.-how-to-update)\
2 . [Choose your Alby Hub specific flavor](#id-2.-choose-your-alby-hub-specific-flavor)\
2.1. [Pro Cloud](#alby-cloud)\
2.2. [Desktop](#desktop)\
2.3. [Docker](#docker)\
2.4. [Umbrel, Start9, etc.](#umbrel-start9-your-own-node)\
2.5. [Ubuntu](#ubuntu)\
3 .[ Congratulations!](#id-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".
{% embed url="" %}
Other Cloud Options
The currently recommended deployment options on our [GitHub repository ](https://github.com/getAlby/hub/tree/master)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](#docker).
***
### Desktop
{% tabs %}
{% tab title="Windows" %}
{% embed url="" %}
Updating Alby Hub on Windows
{% endembed %}
{% endtab %}
{% tab title="macOS" %}
{% embed url="" %}
Updating Alby Hub on macOS
{% endembed %}
{% endtab %}
{% tab title="Ubuntu" %}
1. Download latest release from [GitHub releases](https://github.com/getAlby/hub/releases)
2. Stop current Hub instance
3. Install new version
4. Restart Hub
{% endtab %}
{% endtabs %}
#### 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//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//Library/Containers/com.getalby.albyhub/Data/Library/Application Support"` and then do `cp -r albyhub "/System/Volumes/Data/Users//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:
{% code overflow="wrap" %}
```bash
docker pull ghcr.io/getalby/hub:latest
```
{% endcode %}
```bash
docker stop albyhub
```
```bash
docker rm albyhub
```
```bash
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](https://docs.start9.com/0.3.4.x/user-manual/overview/managing-services#id4)\
**For Umbrel**: Click "Check for updates".\ 
***
### Ubuntu
Manual installation (Ubuntu)
Go to your terminal and run these commands:
{% code overflow="wrap" %}
```bash
# 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
```
{% endcode %}
***
## 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.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://guides.getalby.com/user-guide/alby-hub/alby-hub-flavors/updating.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.