Skip to main content
Backing up your channels is essential to prevent loss of funds if your device fails or the app needs to be reinstalled.
Without a current channel backup, you risk losing funds locked in open Lightning channels. Always create a new backup after opening or closing a channel.

What a Channel Backup Contains

A backup is a complete encrypted archive of your node’s data directory. It captures the full node state — Lightning channel data, RGB asset data, and on-chain wallet state — so a restored node picks up exactly where the backup left off. Backups do not replace your mnemonic phrase. Keep both:
  • Mnemonic phrase — the root of your wallet keys, written down offline
  • Backup file — the node state needed to restore your channels and assets

Creating a Channel Backup

1

Open Backup Wallet

Open the account menu (top right) and click Backup Wallet, or go to Settings → Security & Backup → Backup Wallet.
2

Choose a Destination

Select a secure location to save the backup file. Choose somewhere you can access later — ideally an external drive or encrypted cloud storage.
3

Enter Your Node Password

Input your node password. The backup file is encrypted with this password.
4

Create the Backup

Click Create Backup. The encrypted backup file is saved to your chosen destination. The node stays locked until the backup finishes.
Backup Wallet screen in Desktop App

When to Create a New Backup

Create a fresh backup after any of the following events:
  • Opening a new channel
  • Closing a channel
  • After restoring from a previous backup
  • On a regular schedule (e.g., weekly)
Each backup reflects the channel state at the time it was created. An outdated backup may not include your newest channels.

Restoring from a Backup

If you need to restore your wallet on a new device:
  1. Reinstall the KaleidoSwap Desktop App
  2. On the welcome screen choose Local Node, pick a backend, then Restore Wallet
  3. Enter an Account Name, choose the network, select the Backup File and enter its Password (the node password you set when creating it), then click Restore Wallet
  4. Allow the node to start and sync
Because the backup contains the complete node state, your channels resume operating normally after the restore — no mnemonic entry is required and no force-closes are triggered.
Backups taken with v0.5.0 or earlier cannot be restored in v0.5.1.
The backup is encrypted with your node password. Without that password, the backup file cannot be decrypted or restored.

Download the Desktop App

Get the latest KaleidoSwap Desktop App release for macOS, Windows, or Linux.