LNbits

LNbits

Offiziell

Docker-Anwendung from Raccommode's Repository

Übersicht

LNbits is a free and open-source Bitcoin Lightning wallet and accounts system. It provides isolated wallets, API keys, LNURL tools, extensions, merchant workflows, and admin controls on top of a configurable Lightning funding source.

Anforderungen

LNbits stores its SQLite database, logs, super user state, and installed extensions in the Data path. Back this directory up before using real funds. The default backend is VoidWallet so the UI can start without a Lightning node; set Backend Wallet Class and the matching advanced variables before accepting real payments. The Admin UI stores most settings in the database after first install, so use the Admin UI or reset stored settings if later environment changes do not appear.

Laufzeit-Argumente

Web-UI
http://[IP]:[PORT:5000]
Netzwerk
bridge
Shell
sh
Privilegiert
false

Konfiguration der Vorlage

Web UI PortPorttcp

LNbits web interface and API port. Container port: 5000.

Ziel
5000
Standard
5000
Wert
5000
DataPathrw

Persistent LNbits data, SQLite database, logs, super user state, backups, and installed extensions.

Ziel
/app/data
Standard
/mnt/user/appdata/lnbits
Wert
/mnt/user/appdata/lnbits
Config FilePathro

Optional .env file based on the upstream .env.example. Leave blank to configure with the variables in this template and the Admin UI.

Ziel
/app/.env
Data FolderVariable

LNbits data folder inside the container. Keep this pointed at the Data mount.

Ziel
LNBITS_DATA_FOLDER
Standard
/app/data
Wert
/app/data
Extensions PathVariable

Persistent path for installed LNbits extensions. Without this, installed extensions can be lost when the container is recreated.

Ziel
LNBITS_EXTENSIONS_PATH
Standard
/app/data/extensions
Wert
/app/data/extensions
Admin UIVariable

Enable the LNbits Admin UI and first-install super user flow. Use true or false.

Ziel
LNBITS_ADMIN_UI
Standard
true
Wert
true
HTTPS Only Auth CookiesVariable

Set true when LNbits is served only over HTTPS. Leave false for direct local HTTP access through the Unraid Web UI.

Ziel
AUTH_HTTPS_ONLY
Standard
false
Wert
false
Backend Wallet ClassVariable

Lightning funding source class. Start with VoidWallet for testing, then use PhoenixdWallet, LndRestWallet, LndWallet, CoreLightningWallet, or another supported backend.

Ziel
LNBITS_BACKEND_WALLET_CLASS
Standard
VoidWallet
Wert
VoidWallet
Default ExtensionsVariable

Comma-separated extensions installed by default on restart. Remove an extension from this list before uninstalling it permanently.

Ziel
LNBITS_EXTENSIONS_DEFAULT_INSTALL
Standard
tpos
Wert
tpos
Public Base URLVariable

Optional public URL used behind a reverse proxy, for example https://lnbits.example.com/.

Ziel
LNBITS_BASEURL
Site TitleVariable

Browser and UI title for this LNbits instance.

Ziel
LNBITS_SITE_TITLE
Standard
LNbits
Wert
LNbits
Auth Secret KeyVariable

Recommended strong random secret for auth signing. Set this before production use.

Ziel
AUTH_SECRET_KEY
First Install TokenVariable

Optional token required on the first-install page.

Ziel
FIRST_INSTALL_TOKEN
Allowed Auth MethodsVariable

Comma-separated auth methods, for example user-id-only, username-password, nostr-auth-nip98, google-auth, github-auth, keycloak-auth, or oidc-auth.

Ziel
AUTH_ALLOWED_METHODS
Standard
user-id-only, username-password
Wert
user-id-only, username-password
DebugVariable

Enable verbose debug mode. Use True or False.

Ziel
DEBUG
Standard
False
Wert
False
Forwarded Allow IPsVariable

Trusted proxy IPs for forwarded headers. Use * when LNbits is behind a trusted local reverse proxy.

Ziel
FORWARDED_ALLOW_IPS
Standard
*
Wert
*
Postgres Database URLVariable

Optional external database URL. Leave blank to use SQLite in the Data path.

Ziel
LNBITS_DATABASE_URL
Phoenixd API EndpointVariable

Required when Backend Wallet Class is PhoenixdWallet. Use the reachable Phoenixd HTTP API URL, for example http://UNRAID-IP:9740/ or http://phoenixd:9740/ on a custom Docker network.

Ziel
PHOENIXD_API_ENDPOINT
Phoenixd API PasswordVariable

Required when Backend Wallet Class is PhoenixdWallet. Use the Phoenixd full-access API password from phoenix.conf.

Ziel
PHOENIXD_API_PASSWORD
LND DataPathro

Optional read-only mount for an LND data directory. Useful when using LndWallet or LndRestWallet with cert and macaroon paths under /lnd.

Ziel
/lnd
LND REST EndpointVariable

Required when Backend Wallet Class is LndRestWallet. Use the reachable LND REST URL, for example https://UNRAID-IP:8081/ or https://lnd:8080/ on a custom Docker network.

Ziel
LND_REST_ENDPOINT
LND REST CertVariable

LND TLS certificate path inside the LNbits container, or the certificate content accepted by LNbits.

Ziel
LND_REST_CERT
Standard
/lnd/tls.cert
Wert
/lnd/tls.cert
LND REST MacaroonVariable

LND admin macaroon path inside the LNbits container, or hex/base64 macaroon content.

Ziel
LND_REST_MACAROON
Standard
/lnd/data/chain/bitcoin/mainnet/admin.macaroon
Wert
/lnd/data/chain/bitcoin/mainnet/admin.macaroon
LND gRPC EndpointVariable

Required when Backend Wallet Class is LndWallet. Hostname or IP of the LND gRPC endpoint.

Ziel
LND_GRPC_ENDPOINT
LND gRPC PortVariable

Required when Backend Wallet Class is LndWallet. LND gRPC port.

Ziel
LND_GRPC_PORT
Standard
10009
Wert
10009
LND gRPC CertVariable

LND TLS certificate path inside the LNbits container, or the certificate content accepted by LNbits.

Ziel
LND_GRPC_CERT
Standard
/lnd/tls.cert
Wert
/lnd/tls.cert
LND gRPC MacaroonVariable

LND admin macaroon path inside the LNbits container, or hex/base64 macaroon content.

Ziel
LND_GRPC_MACAROON
Standard
/lnd/data/chain/bitcoin/mainnet/admin.macaroon
Wert
/lnd/data/chain/bitcoin/mainnet/admin.macaroon

Einzelheiten

Repository
lnbits/lnbits:latest
Zuletzt aktualisiert2026-06-01
Erstmals gesehen2026-05-19

Führen Sie LNbits auf Unraid aus.

LNbits ist gelistet in Community Apps für Unraid OS. Erkunden Sie Unraid, um einen flexiblen Heimserver, ein NAS oder ein Heimlabor aufzubauen.