Caprover logo
Caprover one-click apps browser
BTCPay Server logo
BTCPay Server
Free, open-source & self-hosted, Bitcoin payment processor.
Official integration
Created - Last update

BTCPay Server is a free, open-source & self-hosted bitcoin payment gateway. It allows self-sovereign individuals and businesses to accept bitcoin payments online or in person without any fees. This will deploy BTCPay Server with Bitcoin Full Node (with 50 GB pruning), Core Lightning Node, Spark Wallet and Ride The Lightning. Please note that features like SSH access and Onion service have been omitted to keep deployment simple. You may need to open the port `9735` in your firewall.

Deployed services
btcpayserver
btcpayserver/btcpayserver:$$cap_BTCPAYSERVER_VERSION
  • btcpayserver-data:/datadir
  • btcpayserver-nbxplorer-data:/root/.nbxplorer
  • btcpayserver-plugins:/root/.btcpayserver/Plugins
  • btcpayserver-lightning-data:/etc/clightning_bitcoin
  • btcpayserver-lightning-spark:/etc/clightning_bitcoin_spark
  • btcpayserver-lightning-rtl-data:/etc/clightning_bitcoin_rtl
  • btcpayserver-lightning-rest-certificates:/etc/clightning_bitcoin_rest_certs
$$cap_BTCPAY_PORT
15
btcpayserver-postgres
custom
  • btcpayserver-postgres:/var/lib/postgresql/data
1
btcpayserver-nbxplorer
nicolasdorier/nbxplorer:$$cap_NBXPLORER_VERSION
  • btcpayserver-nbxplorer-data:/datadir
  • btcpayserver-bitcoind-data:/root/.bitcoin
10
btcpayserver-bitcoind
btcpayserver/bitcoin:$$cap_BITCOIN_VERSION
  • btcpayserver-bitcoind-wallet-data:/walletdata
  • btcpayserver-bitcoind-data:/data
3
btcpayserver-lightning
btcpayserver/lightning:$$cap_LIGHTNING_VERSION
  • btcpayserver-lightning-data:/root/.lightning
  • btcpayserver-bitcoind-data:/etc/bitcoin
  • btcpayserver-nbxplorer-data:/root/.nbxplorer
7
btcpayserver-lightning-spark
shesek/spark-wallet:$$cap_LIGHTNING_SPARK_VERSION
  • btcpayserver-lightning-data:/etc/lightning
  • btcpayserver-lightning-spark:/data
2
btcpayserver-lightning-rest
saubyk/c-lightning-rest:$$cap_LIGHTNING_REST_VERSION
  • btcpayserver-lightning-data:/root/.lightning
  • btcpayserver-bitcoind-data:/etc/bitcoin
  • btcpayserver-lightning-rest-certificates:/usr/src/app/certs
  • btcpayserver-nbxplorer-data:/root/.nbxplorer
3
btcpayserver-rtl
shahanafarooqui/rtl:$$cap_RTL_VERSION
  • btcpayserver-lightning-data:/root/.lightning
  • btcpayserver-bitcoind-data:/etc/bitcoin
  • btcpayserver-lightning-rtl-data:/data
  • btcpayserver-lightning-rest-certificates:/etc/clightning_bitcoin_rest_certs
9
Variables

General | Bind Address

Default: 0.0.0.0

$$cap_BIND_ADDRESS
Address to bind the services.

General | BTCPay Server Version

Default: 1.6.11

$$cap_BTCPAYSERVER_VERSION
Check out their valid tags at https://hub.docker.com/r/btcpayserver/btcpayserver/tags

General | PostgreSQL Version

Default: 13.7

$$cap_POSTGRES_VERSION
Check out their valid tags at https://hub.docker.com/r/btcpayserver/postgres/tags

General | NBXplorer Version

Default: 2.3.38

$$cap_NBXPLORER_VERSION
Check out their valid tags at https://hub.docker.com/r/nicolasdorier/nbxplorer/tags

General | Bitcoin Node Version

Default: 23.0

$$cap_BITCOIN_VERSION
Check out their valid tags at https://hub.docker.com/r/btcpayserver/bitcoin/tags

General | Lightning Version

Default: v0.10.2

$$cap_LIGHTNING_VERSION
Check out their valid tags at https://hub.docker.com/r/btcpayserver/lightning/tags

General | Lightning Spark Version

Default: 0.3.1-standalone

$$cap_LIGHTNING_SPARK_VERSION
Check out their valid tags at https://hub.docker.com/r/shesek/spark-wallet/tags

General | Lightning REST Version

Default: 0.9.0

$$cap_LIGHTNING_REST_VERSION
Check out their valid tags at https://hub.docker.com/r/saubyk/c-lightning-rest/tags

General | Ride The Lightning Version

Default: 0.13.1

$$cap_RTL_VERSION
Check out their valid tags at https://hub.docker.com/r/shahanafarooqui/rtl/tags

General | Network Type

Default: mainnet

$$cap_NBITCOIN_NETWORK
The type of Bitcoin network to use (e.g. `mainnet`, `testnet`, or `regtest`)

Explorer | Chain

Default: btc

$$cap_USED_CHAIN
Blockchain to be used. Defaults is `btc` and should **not** be changed.

Database | Port

Default: 5432

$$cap_POSTGRES_PORT
Port of the PostgreSQL database host.

Database | User

Default: postgres

$$cap_POSTGRES_USER
User of the PostgreSQL database.

Database | Authentication Method

Default: trust

$$cap_POSTGRES_HOST_AUTH_METHOD
Method of authentication for incoming connections in PostgreSQL.

Application | Root Path

Default: /

$$cap_BTCPAY_ROOTPATH
Root path of the application.

Application | Port

Default: 49392

$$cap_BTCPAY_PORT
Port of the application host.

Application | Debug Log

Default: btcpay.log

$$cap_BTCPAY_DEBUGLOG
Log file for debugging information.

Application | Update URL

Default: https://api.github.com/repos/btcpayserver/btcpayserver/releases/latest

$$cap_BTCPAY_UPDATEURL
URL to BTCPay Server releases.

Explorer | Port

Default: 32838

$$cap_NBXPLORER_PORT
Port of the NBXplorer host.

Explorer | Trim Events

Default: 10000

$$cap_NBXPLORER_TRIMEVENTS
Trim the amount of events in NBXplorer.

Explorer | Signal Files Directory

Default: /datadir

$$cap_NBXPLORER_SIGNALFILESDIR
Path to signal files directory in NBXplorer.

Explorer | Automatic Migrations

Default: true

$$cap_NBXPLORER_AUTOMIGRATE
Whether to enable automatic migrations.

Explorer | Event Migrations

Default: true

$$cap_NBXPLORER_NOMIGRATEEVTS
Whether to disable event migrations.

Bitcoin Node | RPC Port

Default: 43782

$$cap_BITCOIN_RPC_PORT
Port of Bitcoin node RPC.

Bitcoin Node | Node Port

Default: 39388

$$cap_BITCOIN_NODE_PORT
Port of Bitcoin node endpoint.

Bitcoin Node | Wallet Directory

Default: /walletdata

$$cap_BITCOIN_WALLETDIR
Path to wallet files directory of the Bitcoin node.

Bitcoin Node | Maximum Mempool Size

Default: 500

$$cap_BITCOIN_MAX_MEMPOOL
Maximum Bitcoin node mempool size in megabytes.

Bitcoin Node | Allowlist Subnet

Default: 0

$$cap_BITCOIN_IP_ALLOWLIST_CIDR
Whitelist IP subnet using CIDR notation for the Bitcoin node.

Bitcoin Node | Prune

Default: 50000

$$cap_BITCOIN_PRUNE
Configure a disk space on stored blocks of the Bitcoin node, denoted in megabytes. Default is 50 gigabytes, this will keep around 6 months of blocks.

Bitcoin Node | Additional Arguments

Default: undefined

$$cap_BITCOIN_ADDITIONAL_ARGUMENTS
Additional Bitcoin node startup arguments.

Lightning Node | Announced Address

Default: undefined

$$cap_LIGHTNINGD_ANNOUNCEADDR
IP address of your server. E.g. `123.123.123.123`.

Lightning Node | Alias

Default: my-awesome-node-$$cap_gen_random_hex(32)

$$cap_LIGHTNINGD_ALIAS
An alias for your Lightning node.

Lightning Node | Port

Default: 9735

$$cap_LIGHTNINGD_PORT
Port of your Lightning node host.

Lightning Node | Ready File

Default: /root/.nbxplorer/btc_fully_synched

$$cap_LIGHTNINGD_READY_FILE
Path to Bitcoin node ready status indicator file in the Lightning node.

Lightning Node | Bitcoin Data Directory

Default: /etc/bitcoin

$$cap_LIGHTNINGD_BITCOIN_DATA_DIRECTORY
Path to Bitcoin data directory in the Lightning node.

Lightning Node | Additional Arguments

Default: undefined

$$cap_LIGHTNINGD_ADDITIONAL_ARGUMENTS
Additional Lightning node startup arguments.

Lightning Node | Spark | Lightning Network Files

Default: --no-tls -C /data/.cookie

$$cap_LIGHTNING_SPARK_OPTIONS
Additional start up options for Lightning Spark.

Lightning Node | Spark | Port

Default: 9737

$$cap_LIGHTNING_SPARK_PORT
Port of Lightning Spark host.

Lightning Node | REST | Protocol

Default: http

$$cap_LIGHTNING_REST_PROTOCOL
Which HTTP protocol to use in Lightning REST.

Lightning Node | Spark | Lightning REST API Port

Default: 9835

$$cap_LIGHTNING_REST_LIGHTNINGD_PORT
REST API port of the Lightning node.

Ride The Lightning | Lightning Implementation

Default: CLT

$$cap_RTL_LN_IMPLEMENTATION
Lightning implementation used for Ride The Lightning.

Ride The Lightning | Lightning Configuration

Default: /root/.lightning/config

$$cap_RTL_LIGHTNING_CONFIG_PATH
Path to Lightning configuration for Ride The Lightning.

Ride The Lightning | Lightning REST Server Port

Default: 3001

$$cap_RTL_LN_SERVER_URL_PORT
Port of the Lightning REST server for Ride The Lightning.

Ride The Lightning | Macaroon Path

Default: /etc/clightning_bitcoin_rest_certs

$$cap_RTL_MACAROON_PATH
Path to the macaroon file for Ride The Lightning.

Ride The Lightning | Configuration Path

Default: /data/

$$cap_RTL_CONFIG_PATH
Path to the configuration file for Ride The Lightning.

Ride The Lightning | Bitcoin Configuration Path

Default: /etc/bitcoin/bitcoin.conf

$$cap_RTL_BITCOIND_CONFIG_PATH
Path to the Bitcoin configuration file for Ride The Lightning.

Ride The Lightning | Single-Sign-On

Default: 1

$$cap_RTL_SSO
Whether to use Single-Sign-On for Ride The Lightning.

Ride The Lightning | Cookie Path

Default: /data/.cookie

$$cap_RTL_COOKIE_PATH
Path to the cookie file for Ride The Lightning.

Ride The Lightning | Log-Out Redirect Link

Default: /server/services

$$cap_RTL_LOGOUT_REDIRECT_LINK
Log-Out redirect link for Ride The Lightning.

Ride The Lightning | Port

Default: 3000

$$cap_RTL_PORT
Port of Ride The Lightning host.
© 2025, Built with Gatsby - Source code available on GitHub