BTCPayServer

BTCPayServer

Offiziell

Docker-Anwendung from Raccommode's Repository

Übersicht

BTCPay Server is a free and open-source Bitcoin payment processor for self-hosted stores, invoices, checkout, wallets, point-of-sale flows, plugins, and webhooks without third-party payment processor fees.

Anforderungen

This template runs the BTCPay Server application container only. The officially supported deployment is a Docker Compose stack with Postgres, NBXplorer, and a Bitcoin full node, plus optional reverse proxy and Lightning services. Configure those services separately and point the Postgres, Explorer, and Bitcoin variables below at them before using BTCPay with real funds. If using container names such as postgres or nbxplorer, place all containers on the same custom Docker network.

Laufzeit-Argumente

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

Konfiguration der Vorlage

Web UI PortPorttcp

BTCPay Server web interface and internal API port. Container port: 49392.

Ziel
49392
Standard
49392
Wert
49392
DataPathrw

Persistent BTCPay Server data directory. Back this directory up before processing real payments.

Ziel
/datadir
Standard
/mnt/user/appdata/btcpayserver
Wert
/mnt/user/appdata/btcpayserver
PluginsPathrw

Persistent BTCPay Server plugins directory.

Ziel
/root/.btcpayserver/Plugins
Standard
/mnt/user/appdata/btcpayserver/plugins
Wert
/mnt/user/appdata/btcpayserver/plugins
Bind AddressVariable

Address and port BTCPay binds to inside the container.

Ziel
BTCPAY_BIND
Standard
0.0.0.0:49392
Wert
0.0.0.0:49392
NetworkVariable

Bitcoin network. Use mainnet, testnet, signet, or regtest.

Ziel
BTCPAY_NETWORK
Standard
mainnet
Wert
mainnet
ChainsVariable

Comma-separated crypto chains enabled in BTCPay. This template defaults to Bitcoin only.

Ziel
BTCPAY_CHAINS
Standard
btc
Wert
btc
Public HostVariable

Optional public hostname, for example btcpay.example.com. Use a reverse proxy for HTTPS when exposing BTCPay outside your LAN.

Ziel
BTCPAY_HOST
Root PathVariable

BTCPay root path when served from a subpath. Use / for normal deployments.

Ziel
BTCPAY_ROOTPATH
Standard
/
Wert
/
Postgres ConnectionVariable

Required Postgres connection string for the BTCPay Server database.

Ziel
BTCPAY_POSTGRES
Standard
User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;Database=btcpayservermainnet
Wert
User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;Database=btcpayservermainnet
Explorer Postgres ConnectionVariable

Required Postgres connection string for NBXplorer data, used by BTCPay to read explorer state.

Ziel
BTCPAY_EXPLORERPOSTGRES
Standard
User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;MaxPoolSize=80;Database=nbxplorermainnet
Wert
User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;MaxPoolSize=80;Database=nbxplorermainnet
BTC Explorer URLVariable

Required NBXplorer URL for Bitcoin, for example http://nbxplorer:32838/ on a custom Docker network or http://UNRAID-IP:32838/.

Ziel
BTCPAY_BTCEXPLORERURL
Standard
http://nbxplorer:32838/
Wert
http://nbxplorer:32838/
Docker Deployment ModeVariable

Marks this BTCPay instance as Docker-deployed. Use true or false.

Ziel
BTCPAY_DOCKERDEPLOYMENT
Standard
true
Wert
true
No Default ChainVariable

Prevents BTCPay from assuming a chain without explicit chain variables. Use true or false.

Ziel
BTCPAY_NODEFAULTCHAIN
Standard
true
Wert
true
Update URLVariable

Release URL used by BTCPay to check for new versions.

Ziel
BTCPAY_UPDATEURL
Standard
https://api.github.com/repos/btcpayserver/btcpayserver/releases/latest
Wert
https://api.github.com/repos/btcpayserver/btcpayserver/releases/latest
Debug LogVariable

Debug log filename under the BTCPay data directory.

Ziel
BTCPAY_DEBUGLOG
Standard
btcpay.log
Wert
btcpay.log
Lightning ConnectionVariable

Optional Bitcoin Lightning connection string. For example, type=clightning;server=unix://etc/clightning_bitcoin/lightning-rpc, or leave blank to configure later in BTCPay.

Ziel
BTCPAY_BTCLIGHTNING

Einzelheiten

Repository
btcpayserver/btcpayserver:2.3.9
Zuletzt aktualisiert2026-05-31
Erstmals gesehen2026-05-19

Führen Sie BTCPayServer auf Unraid aus.

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