> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kaleidoswap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation Guide

> Step-by-step instructions for installing KaleidoSwap Desktop App on macOS, Windows, and Linux

## Installation Methods

You can install the Kaleidoswap Desktop App in two ways:

### 1. Download Binaries

1. **Download**: Visit the [Releases](https://github.com/kaleidoswap/desktop-app/releases) page and download the appropriate binary for your operating system.
2. **Verify**: Download the `manifest.txt` and `manifest.txt.sig` files to verify the authenticity of your download. See our [Binary Verification Guide](/desktop-app/getting-started/verify-binaries) for detailed instructions.
3. **Install**: Run the app by executing the binary.

### 2. Building Locally

#### Common Prerequisites

* **Tauri 1.6.0**\
  Make sure you have installed all the [official Tauri prerequisites](https://tauri.app/v1/guides/getting-started/prerequisites) (Rust, Node.js, npm, pnpm).
* **Repository**
  ```sh theme={null}
  git clone https://github.com/kaleidoswap/desktop-app
  cd desktop-app
  ```

#### Platform-Specific Instructions

**Windows:**

* The `rgb-lightning-node` integration is not yet fully supported on Windows
* Consider using a Docker container for RLN and connect remotely
* Install [vcpkg](https://github.com/microsoft/vcpkg) to install libraries like **openssl** and **sqlite3**
* Ensure **Microsoft Visual C++** is installed (via Visual Studio or Build Tools)

**Linux:**

* Install `build-essential`, `pkg-config`, and SSL libraries
* Install GTK and WebKit requirements (libsoup 2.4, javascriptcoregtk 4.0, webkit2gtk 4.0)
* Confirm correct installation of Rust, Node.js, npm, and pnpm

#### Building and Running

1. **Install dependencies**:
   ```sh theme={null}
   npm install
   ```
2. **Build the Tauri app**:
   ```sh theme={null}
   tauri build
   ```
3. **Run Kaleidoswap in development mode**:
   ```sh theme={null}
   tauri dev
   ```

## Node Setup Options

After installing KaleidoSwap, you'll need to connect to an RGB Lightning Node. You have two options:

### Option 1: Connect to a Remote Node

If you prefer not to run a node on your local machine, you can connect to a remote RGB Lightning Node:

* **Self-hosted remote node**: Learn how to set up your own RGB Lightning Node on a VPS or server by following our [RGB Lightning Node Hosting](/desktop-app/getting-started/node-hosting) guide.
* **Hosted provider**: Connect to a professionally managed node from a service provider like ThunderStack.

**Advantages of remote nodes:**

* No local resources required
* 24/7 availability (for hosted solutions)
* Simplified setup process

### Option 2: Create a Local Wallet with Integrated Node

For complete control and privacy, you can run a node directly on your machine:

* Follow the [Creating a New Wallet](/desktop-app/wallet/creating-wallet) guide to set up a local wallet with an integrated RGB Lightning Node.

**Advantages of local nodes:**

* Full control over your node
* Enhanced privacy
* No dependency on external services

Choose the option that best fits your technical skills and requirements before proceeding with the KaleidoSwap setup.