# LNbits

LNbits is a free, open-source Bitcoin Lightning wallet and account system for users, merchants, and administrators who need isolated wallets, application programming interface (API) keys, Lightning URI (LNURL) tools,. It is open source and self-hosted, installable on Docker Hub, Umbrel and Unraid.

Canonical page: https://ourlocalhost.com/app/225/lnbits

## Description

LNbits is a free, open-source Bitcoin Lightning wallet and account system for users, merchants, and administrators who need isolated wallets, application programming interface (API) keys, Lightning URI (LNURL) tools, extensions, and merchant workflows on a configurable Lightning funding source.

## Platform availability

Available on 3 of 9 platforms: Unraid, Umbrel, Linux.

## Desktop and other devices

Linux.

## Health score

78/100 (Good), based on 3 of 4 factors.
- Maintained: 100 (last commit 15 days ago)
- Popular: 62 (1,234 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)

## Links

- Documentation: https://docs.lnbits.org
- Docker Hub: https://hub.docker.com/r/lnbits/lnbits
- Umbrel: https://apps.umbrel.com/app/lnbits
- Unraid: https://ca.unraid.net/apps/lnbits-0kdu9k90jsqs3h?q=LNbits
- Official website: https://lnbits.com
- desktop: https://github.com/lnbits/lnbits/releases/latest
- GitHub: https://github.com/lnbits/lnbits

## Common questions

### What PostgreSQL setup must be done before starting LNbits?

Install PostgreSQL, set a password for the postgres user, and create the lnbits database first. If that database is missing, LNbits has no place to store its data.

### Where do I find reverse proxy and Tor configuration guidance for LNbits?

The networking FAQ covers Tor access, clearnet domains, Caddy or Nginx reverse proxy, WebSocket connection errors, and SSL/TLS certificate issues.

### Does LNbits have a documented generic OIDC authentication setup?

Yes, the documentation includes a configuration section for generic OIDC authentication.

### Can I change LNbits to a different Lightning funding source later?

Yes, LNbits runs on top of Lightning funding sources and can switch sources without refactoring.

---
Source: Our Local Host (https://ourlocalhost.com/app/225/lnbits), the self-hosted and open-source app directory.