Retour aux applicationsSoumettre
BTCPayServer

BTCPayServer

Officielle

Application Docker from Raccommode's Repository

Vue d'ensemble

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.

Exigences

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.

Arguments d'exécution

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

Configuration du modèle

Web UI PortPorttcp

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

Cible
49392
Défaut
49392
Valeur
49392
DataPathrw

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

Cible
/datadir
Défaut
/mnt/user/appdata/btcpayserver
Valeur
/mnt/user/appdata/btcpayserver
PluginsPathrw

Persistent BTCPay Server plugins directory.

Cible
/root/.btcpayserver/Plugins
Défaut
/mnt/user/appdata/btcpayserver/plugins
Valeur
/mnt/user/appdata/btcpayserver/plugins
Bind AddressVariable

Address and port BTCPay binds to inside the container.

Cible
BTCPAY_BIND
Défaut
0.0.0.0:49392
Valeur
0.0.0.0:49392
NetworkVariable

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

Cible
BTCPAY_NETWORK
Défaut
mainnet
Valeur
mainnet
ChainsVariable

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

Cible
BTCPAY_CHAINS
Défaut
btc
Valeur
btc
Public HostVariable

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

Cible
BTCPAY_HOST
Root PathVariable

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

Cible
BTCPAY_ROOTPATH
Défaut
/
Valeur
/
Postgres ConnectionVariable

Required Postgres connection string for the BTCPay Server database.

Cible
BTCPAY_POSTGRES
Défaut
User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;Database=btcpayservermainnet
Valeur
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.

Cible
BTCPAY_EXPLORERPOSTGRES
Défaut
User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;MaxPoolSize=80;Database=nbxplorermainnet
Valeur
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/.

Cible
BTCPAY_BTCEXPLORERURL
Défaut
http://nbxplorer:32838/
Valeur
http://nbxplorer:32838/
Docker Deployment ModeVariable

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

Cible
BTCPAY_DOCKERDEPLOYMENT
Défaut
true
Valeur
true
No Default ChainVariable

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

Cible
BTCPAY_NODEFAULTCHAIN
Défaut
true
Valeur
true
Update URLVariable

Release URL used by BTCPay to check for new versions.

Cible
BTCPAY_UPDATEURL
Défaut
https://api.github.com/repos/btcpayserver/btcpayserver/releases/latest
Valeur
https://api.github.com/repos/btcpayserver/btcpayserver/releases/latest
Debug LogVariable

Debug log filename under the BTCPay data directory.

Cible
BTCPAY_DEBUGLOG
Défaut
btcpay.log
Valeur
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.

Cible
BTCPAY_BTCLIGHTNING

Catégories

Network > OtherTools > Utilities

Liens

ModèleSoutienHub DockerProprojet

Détails

Référentiel
btcpayserver/btcpayserver:2.3.9
Registre
https://hub.docker.com/r/btcpayserver/btcpayserver
Dernière mise à jour2026-06-01
Première vue2026-05-19

Exécutez BTCPayServer sur Unraid.

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

Explorez Unraid OS