> For the complete documentation index, see [llms.txt](https://docs.thunderstack.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thunderstack.org/bitcoin-native-infrastructure/readme/getting-started-with-thunderstack-rgb-cloud/general/upgrade-rln-node.md).

# Upgrade RLN Node

### **1. UI Upgrade Flow**

When an RLN node is outdated, users will see a notification block on the **Node Page** prompting them to upgrade.

#### **Notification Block**

The notification will appear at the top of the node details page and include the following message:

> **"Please note: Your current RLN image version is no longer supported. Update your node to the latest version."**

<figure><img src="/files/MtgNH3ay1Jw8IdejCFDG" alt=""><figcaption></figcaption></figure>

#### **Steps to Upgrade the Node**

1. **Click the "Upgrade" Button**
   * Navigate to the node page where the notification block appears.
   * Click the **"Update"** button to trigger the upgrade process.
   * This action initiates the upgrade to the latest RLN image version.
2. **Wait for the Upgrade to Complete**
   * The upgrade process may take a few minutes.
   * During this time, the node will be **locked**
3. **Unlock the Node**

   * Once the upgrade is complete, the node will remain **locked**.
   * To resume using the node:
     * Click the **"Unlock"** button displayed on the node page.
   * After unlocking, the node will be fully operational and updated to the latest version.

### **2. Automatic Bulk Upgrade (Scale or Wallet Plan Feature)**

For users subscribed to the **Scale or** **Wallet Plan (see** [**Billing**](broken://pages/KnQ2mWQGOlQ6SBggEmOF)**)**, the system provides a feature for **automatic bulk upgrades**.

**How Automatic Bulk Upgrades Work**

* When a new RLN image version is released, all user nodes are **automatically upgraded** to the latest version.
* Users will **not** need to manually trigger the upgrade process.

**Post-Upgrade Requirement: Unlock Nodes**

After the automatic upgrade, **all upgraded nodes will be locked**. To continue using each node:

1. Navigate to the **Node Page** for the respective node.
2. Click the **"Unlock"** button to unlock the node.

**Important Notes for Wallet Plan Users**

* Automatic bulk upgrades ensure all nodes stay up-to-date without user intervention.
* However, **manual unlocking** is required for **each upgraded node** to resume functionality.

### **3. Upgrade** RLN Node Using the API

This section explains how to upgrade RLN nodes programmatically using API endpoints. Follow the steps below to check, trigger, and finalize an upgrade

### **1. Check the Latest RLN Image**

#### **Endpoint**

`GET /api/nodes/latest-rln-image`

#### **Description**

Fetch the latest version of the RLN node image available for upgrade.

#### **Action**

* Compare your node's current `rln_commit_id` with the `data` in the response.
* If the values differ, an **upgrade is required**.

### **2. Trigger the Node Upgrade**

#### **Endpoint**

`POST /api/nodes/{id}/upgrade`

#### **Description**

Trigger an upgrade for a specific node to the latest version.

#### **Action**

* Initiate the upgrade process for the specified node.

### **3. Unlock the Node After Upgrade**

#### **Endpoint**

`POST https://node-api.thunderstack.org/${userId}/{nodeId}/unlock`

#### **Description**

After the upgrade is complete, nodes remain **locked**. Unlock the node to continue using it.