BTCPayServer

BTCPayServer

Oficial

Aplicación Docker from Raccommode's Repository

Visión general

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.

Requisitos

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.

Argumentos en tiempo de ejecución

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

Configuración de plantillas

Web UI PortPorttcp

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

Objetivo
49392
Por defecto
49392
Valor
49392
DataPathrw

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

Objetivo
/datadir
Por defecto
/mnt/user/appdata/btcpayserver
Valor
/mnt/user/appdata/btcpayserver
PluginsPathrw

Persistent BTCPay Server plugins directory.

Objetivo
/root/.btcpayserver/Plugins
Por defecto
/mnt/user/appdata/btcpayserver/plugins
Valor
/mnt/user/appdata/btcpayserver/plugins
Bind AddressVariable

Address and port BTCPay binds to inside the container.

Objetivo
BTCPAY_BIND
Por defecto
0.0.0.0:49392
Valor
0.0.0.0:49392
NetworkVariable

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

Objetivo
BTCPAY_NETWORK
Por defecto
mainnet
Valor
mainnet
ChainsVariable

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

Objetivo
BTCPAY_CHAINS
Por defecto
btc
Valor
btc
Public HostVariable

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

Objetivo
BTCPAY_HOST
Root PathVariable

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

Objetivo
BTCPAY_ROOTPATH
Por defecto
/
Valor
/
Postgres ConnectionVariable

Required Postgres connection string for the BTCPay Server database.

Objetivo
BTCPAY_POSTGRES
Por defecto
User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;Database=btcpayservermainnet
Valor
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.

Objetivo
BTCPAY_EXPLORERPOSTGRES
Por defecto
User ID=postgres;Host=postgres;Port=5432;Application Name=btcpayserver;MaxPoolSize=80;Database=nbxplorermainnet
Valor
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/.

Objetivo
BTCPAY_BTCEXPLORERURL
Por defecto
http://nbxplorer:32838/
Valor
http://nbxplorer:32838/
Docker Deployment ModeVariable

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

Objetivo
BTCPAY_DOCKERDEPLOYMENT
Por defecto
true
Valor
true
No Default ChainVariable

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

Objetivo
BTCPAY_NODEFAULTCHAIN
Por defecto
true
Valor
true
Update URLVariable

Release URL used by BTCPay to check for new versions.

Objetivo
BTCPAY_UPDATEURL
Por defecto
https://api.github.com/repos/btcpayserver/btcpayserver/releases/latest
Valor
https://api.github.com/repos/btcpayserver/btcpayserver/releases/latest
Debug LogVariable

Debug log filename under the BTCPay data directory.

Objetivo
BTCPAY_DEBUGLOG
Por defecto
btcpay.log
Valor
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.

Objetivo
BTCPAY_BTCLIGHTNING

Detalles

Repositorio
btcpayserver/btcpayserver:2.3.9
Última actualización2026-05-31
Visto por primera vez2026-05-19

Ejecute BTCPayServer en Unraid.

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