> 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/lumen.md).

# Lumen

## Lumen – RGB Lightning Node Connector

**Lumen** is a browser extension that connects your browser to an [RGB Lightning Node (RLN)](https://github.com/RGB-Tools/rgb-lightning-node).\
It works as a **bridge** between your node and any dApp that supports the [RGB WebLN interface](https://thunderstack.gitbook.io/rgbln).

Lumen is not a wallet itself — it does not hold your keys or sensitive data.\
Instead, it lets you use your own RGB LN as a wallet backend, either self-hosted or running on **ThunderStack Cloud**.

***

### Features

* Connect to self-hosted or ThunderStack Cloud RGB Lightning Node via HTTP API.
* Exposes node functionality via RGB WebLN.
* Manage RGB assets through your browser.
* Pay and receive invoices.
* Sign messages.
* Use WebLN calls in dApps (e.g. `rgbInvoice`, `sendAsset`).
* Non-custodial: your node manages all private state and signing.

***

### Getting Started

### Installation

The extension will be available on the Chrome Web Store (link to be added).

For development builds, clone the repository and load the extension manually in your browser.

#### 2. Set Up an RGB LN

You have two options:

* **Run your own node**: Install RLN locally, initialize it, and unlock it.
* **Use ThunderStack Cloud**: Simplest option — create a node online, which comes with Biscuit authentication enabled by default.

Guide: [Create a node on ThunderStack Cloud](/bitcoin-native-infrastructure/readme/getting-started-with-thunderstack-rgb-cloud/general/create-rln-node.md)

#### 3. Get Connection Parameters

Once your node is ready and unlocked, go to the **Connect** tab in your node dashboard.

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

<figure><img src="/files/7NWHt910sKajnOVlGlsy" alt=""><figcaption></figcaption></figure>

\
You’ll need:

* **Node API endpoint** (API URL)
* **Node token** (authentication token or Biscuit)

#### 4. Connect in Lumen

1. Open the Lumen extension.<br>

   <figure><img src="/files/zeX6OXohuktigOHcn6xs" alt=""><figcaption></figcaption></figure>
2. Enter the API endpoint and token.
3. Connect.

If successful, your node will show as connected and ready.\
![](/files/iDOGcLgkd6OqnCy08hrl)
