Guide

Quick-start guide to LNbits - choose an installation method, connect a Lightning backend, and start using wallets, payments, and extensions.

Welcome to the LNbits documentation. LNbits is a free and open-source Lightning Network wallet and accounts system.

Getting started

New to LNbits? Start here:

1. What is LNbits? - overview and core concepts
2. Installation - choose your setup method
3. Core features - wallets, payments, API keys

Running a shop, popup, event, or merchant onboarding workflow? Start with the Merchant Stack guide.

Installation

Pick the method that fits your environment:

• Docker - recommended for production
• uv - fastest from-source install
• Poetry - traditional Python setup
• Node platforms - Umbrel, RaspiBlitz, Start9
• All methods →

Connect a Lightning backend

LNbits needs a funding source to process real payments:

• Wallet backends overview
• LND · Core Lightning · and 20+ more

Learn the core

• Wallets and accounts
• API keys
• Payments
• Configuration

Extend

• Extensions overview
• Build your own

Contribute to LNbits

LNbits is built by people like you. Find a task that matches your skills.

DevelopersCore features, extensions, bug fixes

TestersQA, edge cases, bug reports

WritersDocs, blogs, stories, tutorials

DesignersUI, marketing visuals, graphics

EntrepreneursBuild products, run services

AmbassadorsTalks, meetups, community outreach

Find a task that fits you →

Help

• FAQ - answers organized by topic

Related Pages

• What is LNbits? - overview and core concepts
• Installation - choose your setup method
• Core Features - wallets, payments, API keys, and configuration
• Wallet Backends - connect a Lightning funding source