LNbits

LNbits

Oficial

Aplicación Docker from Raccommode's Repository

Visión general

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.

Requisitos

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.

Argumentos en tiempo de ejecución

Interfaz web
http://[IP]:[PORT:5000]
Red
bridge
Concha
sh
Privilegiado
false

Configuración de plantillas

Web UI PortPorttcp

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

Objetivo
5000
Por defecto
5000
Valor
5000
DataPathrw

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

Objetivo
/app/data
Por defecto
/mnt/user/appdata/lnbits
Valor
/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.

Objetivo
/app/.env
Data FolderVariable

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

Objetivo
LNBITS_DATA_FOLDER
Por defecto
/app/data
Valor
/app/data
Extensions PathVariable

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

Objetivo
LNBITS_EXTENSIONS_PATH
Por defecto
/app/data/extensions
Valor
/app/data/extensions
Admin UIVariable

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

Objetivo
LNBITS_ADMIN_UI
Por defecto
true
Valor
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.

Objetivo
AUTH_HTTPS_ONLY
Por defecto
false
Valor
false
Backend Wallet ClassVariable

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

Objetivo
LNBITS_BACKEND_WALLET_CLASS
Por defecto
VoidWallet
Valor
VoidWallet
Default ExtensionsVariable

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

Objetivo
LNBITS_EXTENSIONS_DEFAULT_INSTALL
Por defecto
tpos
Valor
tpos
Public Base URLVariable

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

Objetivo
LNBITS_BASEURL
Site TitleVariable

Browser and UI title for this LNbits instance.

Objetivo
LNBITS_SITE_TITLE
Por defecto
LNbits
Valor
LNbits
Auth Secret KeyVariable

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

Objetivo
AUTH_SECRET_KEY
First Install TokenVariable

Optional token required on the first-install page.

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

Objetivo
AUTH_ALLOWED_METHODS
Por defecto
user-id-only, username-password
Valor
user-id-only, username-password
DebugVariable

Enable verbose debug mode. Use True or False.

Objetivo
DEBUG
Por defecto
False
Valor
False
Forwarded Allow IPsVariable

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

Objetivo
FORWARDED_ALLOW_IPS
Por defecto
*
Valor
*
Postgres Database URLVariable

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

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

Objetivo
PHOENIXD_API_ENDPOINT
Phoenixd API PasswordVariable

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

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

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

Objetivo
LND_REST_ENDPOINT
LND REST CertVariable

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

Objetivo
LND_REST_CERT
Por defecto
/lnd/tls.cert
Valor
/lnd/tls.cert
LND REST MacaroonVariable

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

Objetivo
LND_REST_MACAROON
Por defecto
/lnd/data/chain/bitcoin/mainnet/admin.macaroon
Valor
/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.

Objetivo
LND_GRPC_ENDPOINT
LND gRPC PortVariable

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

Objetivo
LND_GRPC_PORT
Por defecto
10009
Valor
10009
LND gRPC CertVariable

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

Objetivo
LND_GRPC_CERT
Por defecto
/lnd/tls.cert
Valor
/lnd/tls.cert
LND gRPC MacaroonVariable

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

Objetivo
LND_GRPC_MACAROON
Por defecto
/lnd/data/chain/bitcoin/mainnet/admin.macaroon
Valor
/lnd/data/chain/bitcoin/mainnet/admin.macaroon

Detalles

Repositorio
lnbits/lnbits:latest
Última actualización2026-06-02
Visto por primera vez2026-05-19

Ejecute LNbits en Unraid.

LNbits se encuentra en Community Apps para Unraid OS. Explore Unraid para crear un servidor doméstico flexible, un NAS o un laboratorio doméstico.