You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
nicolas.dorier bfa73fcf18
bump btcpay
1 year ago
.circleci Update let's encrypt 3 years ago
Generated Switch to our own postgres container 1 year ago
Production Add Lightning Terminal fragment (#512) 1 year ago
Production-NoReverseProxy Fix Tor issue on old deployments 4 years ago
Tools Remove bitcoin taproot cc 1 year ago
Traefik update readmes 4 years ago
contrib bump btcpay 1 year ago
docker-compose-generator bump btcpay 1 year ago
docs Bump joinmarket to fix receive-payjoin 1 year ago
.gitattributes generate-docker-compose should use docker, add .sh 5 years ago
.gitignore Add chatwoot support system (#353) 1 year ago
LICENSE Init 5 years ago bump btcpay 1 year ago S3 backup provider (#438) 2 years ago
bgold-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
bgold-lncli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
bitcoin-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago fix rpc connection 2 years ago
bitcoin-eclair-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
bitcoin-lightning-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
bitcoin-lncli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
bitcore-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
bplus-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago Add fido2 cred removal in admin script (#467) 2 years ago Do not cleanup the docker-compose-generator 3 years ago Mac os support (#156) 4 years ago Mac os support (#156) 4 years ago change file name which bug updates 5 years ago Update libseccomp2 on any arm32 buster hosts 1 year ago Mac os support (#156) 4 years ago Update libseccomp2 on any arm32 buster hosts 1 year ago
build.ps1 switch to json crypto definitions (#246) 3 years ago Integrate EPS (Electrum Personal Server) (#227) 3 years ago bump let's encrypt to migrate endpoint 3 years ago
dash-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
dogecoin-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
elements-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
feathercoin-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
groestlcoin-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
groestlcoin-eclair-cli.ps1 Add eclair for GRS and fix GRS LND (#269) 3 years ago Add eclair for GRS and fix GRS LND (#269) 3 years ago
groestlcoin-lightning-cli.ps1 Fix chmod (#421) 2 years ago Fix chmod (#421) 2 years ago
groestlcoin-lncli.ps1 Fix chmod (#421) 2 years ago Fix chmod (#421) 2 years ago Update libseccomp2 on any arm32 buster hosts 1 year ago Bump joinmarket to fix receive-payjoin 1 year ago
litecoin-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
litecoin-lightning-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
litecoin-lncli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
monacoin-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago Add NDLC-CLI 2 years ago Add pihole 3 years ago
publish-stable.ps1 helper script 5 years ago
trezarcoin-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago
viacoin-cli.ps1 Do not require ppt for the btcpay scripts 3 years ago Do not require ppt for the btcpay scripts 3 years ago


Start accepting Bitcoin today with BTCPay Server! This guide will walk you through the installation.


While our instructions cover how to install BTCPayServer in one click on Azure or Lunanode, BTCPay Server is not limited to those options.

You will find below information about how you can install BTCPay Server easily in any environment having docker available.



As you can see, BTCPay depends on several pieces of infrastructure, mainly:

  • A lightweight block explorer (NBXplorer),
  • A database (PostgreSQL or SQLite),
  • A full node (eg. Bitcoin Core)

There can be more dependencies if you support more than just standard Bitcoin transactions, including:

Note: The setup process can be time consuming, but is heavily automated to make it a fun and easy experience.

Take a look at how BTCPay works in a video below.

Here is a presentation of the global architecture at Advancing Bitcoin conference.

BTCPay - Architecture overview

Full installation (for technical users)

You can also install BTCPay Server on your own machine or VPS instance.

The officially supported setup is driven by Docker (and Docker-Compose).

First, make sure you have a domain name pointing to your host A record, with ports 443 and 80 externally accessible. For Lightning Network, port 9735 is required (9736 if you use Litecoin Lightning). Otherwise, you will have to set a domain manually by running

Let's assume your domain is

The setup below assumes you want to support Bitcoin, c-lightning, HTTPS automatically configured by Nginx. It also enables node pruning, which you can modify or ignore if you have enough disk space for a full node. Finally, your domain is should reflect your actual domain name.

Environment variables can be tailored to your needs. Some variables require additional storage space.

# Login as root
sudo su -

# Create a folder for BTCPay
mkdir BTCPayServer
cd BTCPayServer

# Clone this repository
git clone
cd btcpayserver-docker

# Run with the right parameters
export BTCPAY_HOST=""
export NBITCOIN_NETWORK="mainnet"
export BTCPAYGEN_CRYPTO1="btc"
export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage-s"
export BTCPAYGEN_LIGHTNING="clightning"
. ./ -i

exit will then:

  • Install Docker
  • Install Docker-Compose
  • Make sure BTCPay starts at reboot via upstart or systemd
  • Setup environment variables to use BTCPay utilities
  • Add BTCPay utilities in /usr/bin
  • Start BTCPay Server

Video below guides you step by step on how to set up BTCPay Server on a VPS with Docker.

Check out this video if you're interested in learning more about setting up BTCPay with Docker Compose.

Docker automated build

Environment variables will use the following environment variables:

  • BTCPAY_HOST: The hostname of your website (eg.
  • BTCPAY_ADDITIONAL_HOSTS: Optional, specify additional domains to your BTCPayServer with https support if enabled. (eg.,
  • REVERSEPROXY_HTTP_PORT: The public port the reverse proxy binds to for HTTP traffic (default: 80)
  • REVERSEPROXY_HTTPS_PORT: The public port the reverse proxy binds to for HTTPS traffic (default: 443)
  • REVERSEPROXY_DEFAULT_HOST: Optional, if using a reverse proxy nginx, specify which website should be presented if the server is accessed by its IP.
  • NBITCOIN_NETWORK: The type of network to use (eg. mainnet, testnet, or regtest. Default: mainnet)
  • LIGHTNING_ALIAS: An alias for your lightning network node, if used
  • BTCPAYGEN_CRYPTO1: First supported crypto currency (eg. btc, ltc. Default: btc)
  • BTCPAYGEN_CRYPTO2: Second supported crypto currency (eg. btc, ltc. Default: (empty))
  • BTCPAYGEN_CRYPTON: N'th supported crypto currency where N is 9 at maximum. (eg. btc, ltc. Default: (empty))
  • BTCPAYGEN_REVERSEPROXY: Specify reverse proxy to use; NGinx has HTTPS support. (eg. nginx, traefik, (empty). Default: nginx)
  • BTCPAYGEN_LIGHTNING: Lightning network implementation to use (eg. clightning, lnd, Default: (empty))
  • BTCPAYGEN_SUBNAME: The subname of the generated docker-compose file, where the full name is Generated/docker-compose.SUBNAME.yml (Default: generated)
  • BTCPAYGEN_ADDITIONAL_FRAGMENTS: Semicolon-separated list of additional fragments you want to use (eg. opt-save-storage)
  • LETSENCRYPT_EMAIL: An email will be sent to this address if certificate expires and fails to renew automatically (eg.
  • ACME_CA_URI: The API endpoint to ask for HTTPS certificate (Default: production)
  • BTCPAY_ENABLE_SSH: Optional, gives BTCPay Server SSH access to the host by allowing it to edit authorized_keys of the host, it can be used for managing the authorized_keys or updating BTCPay Server directly through the website. (Default: false)
  • BTCPAYGEN_DOCKER_IMAGE: Optional, Specify which generator image to use if you have customized the C# generator. Set to btcpayserver/docker-compose-generator:local to build the generator locally at runtime.
  • BTCPAY_IMAGE: Optional, Specify which btcpayserver image to use if you have a customized btcpayserver.
  • BTCPAYGEN_EXCLUDE_FRAGMENTS: Semicolon-separated list of fragments you want to forcefully exclude (eg. litecoin-clightning)
  • TOR_RELAY_NICKNAME: If tor relay is activated with opt-add-tor-relay, the relay nickname
  • TOR_RELAY_EMAIL: If tor relay is activated with opt-add-tor-relay, the email for Tor to contact you regarding your relay

Additionally, there are specific environment variables for some addons:

  • LIBREPATRON_HOST: If libre patron is activated with opt-add-librepatron, the hostname of your libre patron website (eg.
  • ZAMMAD_HOST: If zammad is activated with opt-add-zammad, the hostname of your zammad website (eg.
  • WOOCOMMERCE_HOST: If woocommerce is activated with opt-add-woocommerce, the hostname of your woocommerce website (eg.
  • EPS_XPUB: If Electrum Personal Server (EPS) is activated with opt-add-electrum-ps, you must set the Extended Public Key (XPUB, YPUB or ZPUB) of the wallet you want to use, before first run of the EPS server. If you accidently start EPS without this, it will not work properly as the model of EPS is to monitor only specified wallets.
  • If Bitcoin Wallet Tracker is activated with opt-add-bwt, you can use BWT_XPUB/BWT_XPUB_* (to set your XPUB/YPUB/ZPUB), BWT_DESCRIPTOR/BWT_DESCRIPTOR_* (for script descriptors), BWT_RESCAN_SINCE (set to the wallet creation date in YYYY-MM-DD to speed up the rescan), BWT_BITCOIND_WALLET and BWT_GAP_LIMIT.
  • LND_WTCLIENT_SWEEP_FEE: If LND watchtower is activated with opt-lnd-wtclient, you can use LND_WTCLIENT_SWEEP_FEE to change the sweep fee used in constructing the justice transaction (default is 10 sat/byte)
  • FIREFLY_HOST: If fireflyiii is activated with opt-add-fireflyiii, the hostname of your fireflyiii website (eg.


A wide variety of useful scripts are available once BTCPay is installed:

  • Access your Bitcoin node instance (for RPC)
  • Access your C-Lightning node instance (for RPC)
  • Change the domain of your BTCPayServer (remember to disable 2FA/U2F first, as you risk being unable to log in to your account)
  • Update BTCPayServer to the latest version
  • Run docker-compose up
  • Run docker-compose down
  • Change the settings of your server
  • Purge any unused docker images
  • . ./ Information about additional parameters
  • . ./ -i: Set up your BTCPayServer
  • Restart your BTCPayServer

Under the hood

Generated docker-compose

When you run, your environment variables are used by (or build.ps1) to generate a docker-compose adapted for your needs. For the full list of options, see: Environment variables

By default, the generated file is Generated/docker-compose.generated.yml, constructed from the relevant Docker fragments for your setup.


You can also create your own custom fragments.

If you want to add an option to BTCPAYGEN_ADDITIONAL_FRAGMENTS and re-configure your install:

. -i

For example, if you want btc and ltc support with nginx and clightning inside Generated/docker-compose.custom.yml:

Note: The first run might take a while, but following runs are instantaneous.

On Windows (run in powershell):

Invoke-Command {
    . .\build.ps1

On Linux:


Next, you will need to configure the runtime environment variables for Generated/docker-compose.custom.yml:

Again, what does do? is a utility which does the following:

  1. Makes sure docker and docker-compose are installed on your system
  2. Generates a docker-compose via ./
  3. Sets up an Environment File to configure your docker-compose
  4. Sets up environment variables so the tools described in Tooling can work
  5. Adds symlinks of those tools into /usr/bin
  6. Makes sure BTCPay restarts on reboot via upstart or systemd
  7. Starts BTCPay via docker-compose

Overview of files generated by

/etc/profile.d/ ensures that your environment variables are correctly setup when you login, so you can use the tools:

export BTCPAYGEN_CRYPTO1="btc"
export BTCPAYGEN_LIGHTNING="clightning"
export BTCPAY_DOCKER_COMPOSE="/var/lib/waagent/custom-script/download/0/btcpayserver-docker/Production/docker-compose.generated.yml"
export BTCPAY_BASE_DIRECTORY="/var/lib/waagent/custom-script/download/0"
export BTCPAY_ENV_FILE="/var/lib/waagent/custom-script/download/0/.env"
export BTCPAY_HOST_SSHKEYFILE="/root/.ssh/id_rsa_btcpay"
if cat $BTCPAY_ENV_FILE &> /dev/null; then
  export $(grep -v '^#' "$BTCPAY_ENV_FILE" | xargs)

/etc/systemd/system/btcpayserver.service ensures that you can control btcpay via systemctl, and that BTCPayServer starts on reboot:

Description=BTCPayServer service


ExecStart=/bin/bash -c  '. /etc/profile.d/ && cd "$BTCPAY_BASE_DIRECTORY/btcpayserver-docker" && . && btcpay_up'
ExecStop=/bin/bash -c   '. /etc/profile.d/ && cd "$BTCPAY_BASE_DIRECTORY/btcpayserver-docker" && . && btcpay_down'
ExecReload=/bin/bash -c '. /etc/profile.d/ && cd "$BTCPAY_BASE_DIRECTORY/btcpayserver-docker" && . && btcpay_restart'


.env ($BTCPAY_ENV_FILE) contains environment variables passed to the containers managed by your docker-compose:

How can I add an altcoin to BTCPayServer?

  1. Add support for your crypto to NBitcoin, NBxplorer, and BTCPayServer. (Use examples from other coins)
  2. Create your own docker image (Example for BTC)
  3. Create a docker-compose fragment (Example for BTC)
  4. Add your CryptoDefinition (Example for BTC) is using a pre-built image of the docker-compose generator on docker hub. If you modify the code source of docker-compose generator (for example, the CryptoDefinition Example for BTC), you need to configure to use your own image by setting the environment variable BTCPAYGEN_DOCKER_IMAGE to btcpayserver/docker-compose-generator:local.

cd docker-compose-generator

Or on powershell:

cd docker-compose-generator

Then run ./ or . .\build.ps1. This will generate your docker-compose in the Generated folder, which you can then run and test.

Note that BTCPayServer developers will not spend excessive time testing your image, so make sure it works.


We are trying to update our dependencies to run on arm32v7 and x64 boards. Here is our progress:

Image Version x64 arm32v7 arm64v8 links
btcpayserver/docker-compose-generator latest ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/docker-compose 1.28.6 ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/bitcoin 22.0-1 ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/lightning v0.10.2 ✔️ ✔️ ✔️ Github - DockerHub
shesek/lightning-charge 0.4.23-1-standalone ✔️ ✔️ ✔️ Github - DockerHub
shesek/spark-wallet 0.2.9-standalone ✔️ ✔️ ✔️ Github - DockerHub
saubyk/c-lightning-rest 0.5.2 ✔️ ✔️ ✔️ Github - DockerHub
shahanafarooqui/rtl 0.11.2 ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/lnd v0.14.1-beta ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/bitcointaprootcc/0.21.0-bip8-lottrue latest ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/btcpayserver 1.3.7$<BTCPAY_BUILD_CONFIGURATION>? ✔️ ✔️ ✔️ Github - DockerHub
nicolasdorier/nbxplorer 2.2.18 ✔️ ✔️ ✔️ Github - DockerHub
nginx 1.16.0 ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/docker-gen 0.7.8 ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/letsencrypt-nginx-proxy-companion 1.12.2 ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/btctransmuter 0.0.59 ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/btcpayserver-configurator 0.0.21 ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/eps 0.2.2 ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/joinmarket 0.9.3 ✔️ ✔️ ✔️ Github - DockerHub
nicolasdorier/ndlc-cli 1.0.1 ✔️ ✔️ ✔️ Github - DockerHub
pihole/pihole v5.7 ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/tor ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/postgres 13.4-4 ✔️ ✔️ ✔️ Github - DockerHub
kamigawabul/docker-bitcoingold 0.15.2 ✔️ Github - DockerHub
kamigawabul/btglnd latest ✔️ Github - DockerHub
acinq/eclair release-0.4.1 ✔️ Github - DockerHub
chekaz/docker-bitcoinplus 2.7.0 ✔️ Github - DockerHub
dalijolijo/docker-bitcore ✔️ Github - DockerHub
btcpayserver/dash ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/dogecoin 1.14.4 ✔️ Github - DockerHub
chekaz/docker-feathercoin 0.16.3 ✔️ Github - DockerHub
groestlcoin/docker-groestlcoin 2.21.1 ✔️ Github - DockerHub
groestlcoin/lightning v0.10.0 ✔️ Github - DockerHub
groestlcoin/groestlcoin-lightning-charge version-0.4.22 ✔️ Github - DockerHub
groestlcoin/groestlcoin-spark version-0.2.16 ✔️ Github - DockerHub
groestlcoin/eclair v0.6.0 ✔️ Github - DockerHub
groestlcoin/lnd v0.10.0-grs ✔️ Github - DockerHub
btcpayserver/elements ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/litecoin 0.18.1 ✔️ ✔️ Github - DockerHub
wakiyamap/docker-monacoin 0.20.2 ✔️ Github - DockerHub
btcpayserver/monero ✔️ Github - DockerHub
redis 6.2.2-buster ✔️ Github - DockerHub
bluewalletorganization/lndhub v1.3.3 ✔️ ✔️ Github - DockerHub
jvandrew/btcqbo 0.3.36 ✔️ Github - DockerHub
shesek/bwt 0.2.2-electrum ✔️ ✔️ ✔️ Github - DockerHub
chatwoot/chatwoot v1.7.0 ✔️ Github - DockerHub
lukechilds/electrumx latest ✔️ Github - DockerHub
fireflyiii/core latest ✔️ ✔️ ✔️ Github - DockerHub
jvandrew/librepatron 0.7.39 ✔️ Github - DockerHub
jvandrew/isso atron.22 ✔️ Github - DockerHub
lightninglabs/lightning-terminal v0.6.1-alpha-path-prefix ✔️ Github - DockerHub
sphinxlightning/sphinx-relay v2.2.0 ✔️ ✔️ Github - DockerHub
dennisreimann/tallycoin_connect v1.7.0 ✔️ ✔️ ✔️ Github - DockerHub
talaia/python-teos latest ✔️ ✔️ ✔️ Github - DockerHub
apotdevin/thunderhub base-v0.12.31 ✔️ ✔️ ✔️ Github - DockerHub
btcpayserver/docker-woocommerce 3.0.15 ✔️ Github - DockerHub
mariadb 10.3 ✔️ Github - DockerHub
zammad/zammad-docker-compose zammad-postgresql-3.4.0-4 ✔️ Github - DockerHub
memcached 1.5.22-alpine ✔️ Github - DockerHub
traefik latest ✔️ Github - DockerHub
chekaz/docker-trezarcoin 0.13.0 ✔️ Github - DockerHub
romanornr/docker-viacoin 0.15.2 ✔️ Github - DockerHub


How can I modify my environment?

As root, run .; this will show you the environment variable it is expecting. For example, if you support btc and ltc already, and want to add btg:

export BTCPAYGEN_CRYPTO3='btg'
. -i

I deployed before existed (before May 17, 2018), can I migrate to this new system?

Yes, run the following commands to update:

sudo su -

cd $DOWNLOAD_ROOT/btcpayserver-docker
git checkout master
git pull
git checkout 9acb5d8067cb5c46f59858137feb699b41ac9f19
. ./ -i
git checkout master


I'm getting an error on Windows: Cannot create container for service docker: Mount denied?

If you see this error:

Cannot create container for service docker: b'Mount denied:\nThe source path "\\\\var\\\\run\\\\docker.sock:/var/run/docker.sock"\nis not a valid Windows path'.

Run this in powershell:


Then, run docker-compose -f EXAMPLE.yml up.

This bug comes from Docker for Windows and is tracked on Github.

How I can prune my node(s)?

This will prune your Bitcoin full node to a maximum of 100GB (of blocks):

export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage"
. ./ -i

Other options are documented here.

How can I customize the generated docker-compose file?

In some instances, you might want to customize your environment in more detail. While you could modify Generated/docker-compose.generated.yml manually, your changes would be overwritten the next time you run

Luckily, you can leverage BTCPAYGEN_ADDITIONAL_FRAGMENTS for this!

Let's enable pruning to 60 GB, for example:

First, copy opt-save-storage into the the docker fragment folder as opt-save-storage.custom.yml. Important: the file must end with .custom.yml, or there will be git conflicts whenever you run

Modify the new opt-save-storage.custom.yml file to your taste:

@@ -14,8 +14,7 @@ version: "3"
-       BITCOIN_EXTRA_ARGS: prune=100000
+       BITCOIN_EXTRA_ARGS: prune=60000

Then set it up:

. ./ -i

Can I run BTCPay Server on ports other than 80 and 443?

You can change the ports for HTTP and HTTPS by setting the environment variables REVERSEPROXY_HTTP_PORT and REVERSEPROXY_HTTPS_PORT. This is handy when ports 80 and 443 are already in use on your host, or you want to offload SSL termination with an existing web proxy.

When you set REVERSEPROXY_HTTP_PORT to another value than 80, the built-in Let's Encrypt certificate will not work, as Let's Encrypt will try to validate your SSL certificate request by connecting from the internet to your domain on port 80. This validation request should be able to reach BTCPay Server in order to receive the certificate.

If you need to run on a different port, it's best to terminate SSL using another web proxy and forward your traffic.

Can I offload HTTPS termination?

Yes. Please see the documentation.

How can I back up my BTCPay Server?

We provide a backup script that dumps the database and saves the important files:

cd "$BTCPAY_BASE_DIRECTORY/btcpayserver-docker"

This will save the backup locally as /var/lib/docker/volumes/backup_datadir/_data/backup.tar.gz. These are the options to customize the backup name and location:

  • BACKUP_TIMESTAMP=true saves the backup with datetime as part of the file name, so that backups do not get overwritten.
  • BACKUP_PROVIDER=SCP saves the backup remotely, requires additional SCP_TARGET environment variable (see below).
  • BACKUP_PROVIDER=Dropbox saves the backup to Dropbox, requires additional DROPBOX_TOKEN environment variable (see below).
cd "$BTCPAY_BASE_DIRECTORY/btcpayserver-docker"

# Backup with custom file name and timestamp:

# Backup via SCP:
BACKUP_PROVIDER=SCP SCP_TARGET=myhost:backups/btcpay ./

# Backup to Dropbox:

You can also choose to only dump the database. This option does not need to stop and restart the docker-containers:

cd "$BTCPAY_BASE_DIRECTORY/btcpayserver-docker"
./ --only-db

How can I connect to the database?

On the server you can open a database session by connecting via psql as the postgres user:

docker exec -ti $(docker ps -a -q -f "name=postgres_1") psql -U postgres

Then, inside psql you can select a database and interact with the tables:

# list databases

# connect to database
\c btcpayservermainnet

# list tables

# list users
SELECT "Id", "Email" FROM "AspNetUsers";

# end session