LNbits

LNbits

Officielle

Application Docker from Raccommode's Repository

Vue d'ensemble

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.

Exigences

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.

Arguments d'exécution

Interface utilisateur Web
http://[IP]:[PORT:5000]
Réseau
bridge
Coquille
sh
Privilégié
false

Configuration du modèle

Web UI PortPorttcp

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

Cible
5000
Défaut
5000
Valeur
5000
DataPathrw

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

Cible
/app/data
Défaut
/mnt/user/appdata/lnbits
Valeur
/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.

Cible
/app/.env
Data FolderVariable

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

Cible
LNBITS_DATA_FOLDER
Défaut
/app/data
Valeur
/app/data
Extensions PathVariable

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

Cible
LNBITS_EXTENSIONS_PATH
Défaut
/app/data/extensions
Valeur
/app/data/extensions
Admin UIVariable

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

Cible
LNBITS_ADMIN_UI
Défaut
true
Valeur
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.

Cible
AUTH_HTTPS_ONLY
Défaut
false
Valeur
false
Backend Wallet ClassVariable

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

Cible
LNBITS_BACKEND_WALLET_CLASS
Défaut
VoidWallet
Valeur
VoidWallet
Default ExtensionsVariable

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

Cible
LNBITS_EXTENSIONS_DEFAULT_INSTALL
Défaut
tpos
Valeur
tpos
Public Base URLVariable

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

Cible
LNBITS_BASEURL
Site TitleVariable

Browser and UI title for this LNbits instance.

Cible
LNBITS_SITE_TITLE
Défaut
LNbits
Valeur
LNbits
Auth Secret KeyVariable

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

Cible
AUTH_SECRET_KEY
First Install TokenVariable

Optional token required on the first-install page.

Cible
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.

Cible
AUTH_ALLOWED_METHODS
Défaut
user-id-only, username-password
Valeur
user-id-only, username-password
DebugVariable

Enable verbose debug mode. Use True or False.

Cible
DEBUG
Défaut
False
Valeur
False
Forwarded Allow IPsVariable

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

Cible
FORWARDED_ALLOW_IPS
Défaut
*
Valeur
*
Postgres Database URLVariable

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

Cible
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.

Cible
PHOENIXD_API_ENDPOINT
Phoenixd API PasswordVariable

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

Cible
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.

Cible
/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.

Cible
LND_REST_ENDPOINT
LND REST CertVariable

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

Cible
LND_REST_CERT
Défaut
/lnd/tls.cert
Valeur
/lnd/tls.cert
LND REST MacaroonVariable

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

Cible
LND_REST_MACAROON
Défaut
/lnd/data/chain/bitcoin/mainnet/admin.macaroon
Valeur
/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.

Cible
LND_GRPC_ENDPOINT
LND gRPC PortVariable

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

Cible
LND_GRPC_PORT
Défaut
10009
Valeur
10009
LND gRPC CertVariable

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

Cible
LND_GRPC_CERT
Défaut
/lnd/tls.cert
Valeur
/lnd/tls.cert
LND gRPC MacaroonVariable

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

Cible
LND_GRPC_MACAROON
Défaut
/lnd/data/chain/bitcoin/mainnet/admin.macaroon
Valeur
/lnd/data/chain/bitcoin/mainnet/admin.macaroon

Détails

Référentiel
lnbits/lnbits:latest
Dernière mise à jour2026-06-02
Première vue2026-05-19

Exécutez LNbits sur Unraid.

LNbits est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.