# BTCPayServer BTC chain not syncing after update

**URL:** <https://community.umbrel.com/t/btcpayserver-btc-chain-not-syncing-after-update/24013>\
**Category:** Support and Troubleshooting\
**Created:** [October 3, 2025, 1:36pm UTC](https://community.umbrel.com/t/btcpayserver-btc-chain-not-syncing-after-update/24013 "2025-10-03T13:36:38Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Frog](https://avatars.discourse-cdn.com/v4/letter/f/9fc29f/32.png) [@Frog](https://community.umbrel.com/u/Frog)\
**Post date:** [October 3, 2025, 1:36pm UTC](https://community.umbrel.com/t/btcpayserver-btc-chain-not-syncing-after-update/24013/1 "2025-10-03T13:36:38Z")

</div>

After the upgrade to BTCPay Server v2.2.1+790616d2a on umbrelOS Version 0.5.4, the pay server is not in sync.

 ![image](https://canada1.discourse-cdn.com/flex030/uploads/getumbrel/original/2X/5/52db851a4ea8c5884ba77a0e89efba808b630aae.png)

I was checking various troubleshooting articles, which suggest this is an issue with the container, perhaps with hostname/port variables of the Docker config file.

Also, the status of the NBXplorer container is “Restarting”.

`umbrel@umbrel:~/umbrel/app-data/btcpay-server $ docker container ls -a`  
2f915dc67bd9 nicolasdorier/nbxplorer:2.5.28 “dotnet NBXplorer.dll” 36 minutes ago Restarting (133) 6 seconds ago btcpay-server\_nbxplorer\_1

* * *

The BTCPay Server Docker file follows:

umbrel@umbrel:~/umbrel/app-data/btcpay-server $ cat docker-compose.yml  
version: “3.7”

services:  
app\_proxy:  
environment:  
APP\_HOST: btcpay-server\_web\_1  
APP\_PORT: 3003  
PROXY\_AUTH\_ADD: “false”

nbxplorer:  
image: nicolasdorier/nbxplorer:2.5.28@sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  
user: “1000:1000”  
restart: on-failure  
stop\_grace\_period: 1m  
depends\_on: [postgres]  
volumes:

- ${APP\_DATA\_DIR}/data/nbxplorer:/data  
environment:  
NBXPLORER\_DATADIR: “/data”  
NBXPLORER\_NETWORK: “$APP\_BITCOIN\_NETWORK”  
NBXPLORER\_BIND: 0.0.0.0:32838  
NBXPLORER\_CHAINS: “btc”  
NBXPLORER\_SIGNALFILEDIR: “/data”  
NBXPLORER\_BTCRPCURL: “http://$APP\_BITCOIN\_NODE\_IP:$APP\_BITCOIN\_RPC\_PORT”  
NBXPLORER\_BTCNODEENDPOINT: $APP\_BITCOIN\_NODE\_IP:${APP\_BITCOIN\_P2P\_WHITEBIND\_PORT-${APP\_BITCOIN\_P2P\_PORT}}  
NBXPLORER\_BTCRPCUSER: $APP\_BITCOIN\_RPC\_USER  
NBXPLORER\_BTCRPCPASSWORD: $APP\_BITCOIN\_RPC\_PASS  
NBXPLORER\_POSTGRES: User ID=postgres;Host=btcpay-server\_postgres\_1;Port=5432;Application Name=nbxplorer;MaxPoolSize=20;Database=nbxplorer$APP\_BITCOIN\_NETWORK  
NBXPLORER\_BTCHASTXINDEX: 1

web:  
image: btcpayserver/btcpayserver:2.2.1@sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  
user: “1000:1000”  
restart: on-failure  
stop\_grace\_period: 1m  
depends\_on: [nbxplorer, postgres]  
entrypoint: [“dotnet”, “BTCPayServer.dll”]  
volumes:

- ${APP\_DATA\_DIR}/data/btcpay:/data
- ${APP\_DATA\_DIR}/data/nbxplorer:/data/.nbxplorer
- ${APP\_LIGHTNING\_NODE\_DATA\_DIR}:/lnd:ro  
environment:  
HOME: “/data”  
BTCPAY\_DATADIR: “/data”  
BTCPAY\_PLUGINDIR: “/data/plugins”  
BTCPAY\_DOCKERDEPLOYMENT: “false”  
BTCPAY\_POSTGRES: “User ID=postgres;Host=btcpay-server\_postgres\_1;Port=5432;Database=btcpayserver$APP\_BITCOIN\_NETWORK”  
BTCPAY\_NETWORK: “$APP\_BITCOIN\_NETWORK”  
BTCPAY\_BIND: 0.0.0.0:3003  
BTCPAY\_CHAINS: “btc”  
BTCPAY\_BTCEXPLORERURL: “http://btcpay-server\_nbxplorer\_1:32838”  
BTCPAY\_BTCLIGHTNING: “type=lnd-rest;server=https://$APP\_LIGHTNING\_NODE\_IP:$APP\_LIGHTNING\_NODE\_REST\_PORT/;macaroonfilepath=/lnd/data/chain/bitcoin/$APP\_BITCOIN\_NETWORK/admin.macaroon;allowinsecure=true”  
BTCPAY\_SOCKSENDPOINT: $TOR\_PROXY\_IP:$TOR\_PROXY\_PORT  
BTCPAY\_EXPLORERPOSTGRES: User ID=postgres;Host=btcpay-server\_postgres\_1;Port=5432;Application Name=nbxplorer;MaxPoolSize=20;Database=nbxplorer$APP\_BITCOIN\_NETWORK  
BTCPAY\_TORSERVICES: “btcpayserver:$APP\_HIDDEN\_SERVICE”

postgres:  
image: btcpayserver/postgres:13.13@sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# This needs to run as root for migrations to succeed

# user: “1000:1000”

restart: on-failure

# 

> <https://github.com/btcpayserver/btcpayserver-docker/commit/a65e7db6851092c75c5ac6c091a5f36ccc5fc26e>

command: [“-c”, “random\_page\_cost=1.0”, “-c”, “shared\_preload\_libraries=pg\_stat\_statements”]  
stop\_grace\_period: 1m  
environment:  
POSTGRES\_HOST\_AUTH\_METHOD: trust  
volumes:

- ${APP\_DATA\_DIR}/data/postgres:/var/lib/postgresql/data

* * *

In `/umbrel/app-data/btcpay-server/data/nbxplorer/Main/settings.config`Everything is default/commented.

* * *

umbrel@umbrel:~/umbrel/app-data/btcpay-server $ `ping http://btcpay-server_nbxplorer_1:32838`  
ping: http://btcpay-server\_nbxplorer\_1:32838: Name or service not known

* * *

I don’t know what else to check or where to fix this. I run local DNS (BIND) and NGINX reverse proxy, but no changes there.

Any ideas?

---

<div class="post-metadata">

**Author:** ![Frog](https://avatars.discourse-cdn.com/v4/letter/f/9fc29f/32.png) [@Frog](https://community.umbrel.com/u/Frog)\
**Post date:** [October 5, 2025, 1:59pm UTC](https://community.umbrel.com/t/btcpayserver-btc-chain-not-syncing-after-update/24013/2 "2025-10-05T13:59:26Z")

</div>

Just a small update to the troubleshooting. I have uninstalled BTCPayserver app and reinstalled it.

Symptoms are similar with the fresh installation this time, BTCPayserver won’t even complete start as NBXplorer container is hanged in restart status.

---

<div class="post-metadata">

**Author:** ![Frog](https://avatars.discourse-cdn.com/v4/letter/f/9fc29f/32.png) [@Frog](https://community.umbrel.com/u/Frog)\
**Post date:** [October 11, 2025, 3:15pm UTC](https://community.umbrel.com/t/btcpayserver-btc-chain-not-syncing-after-update/24013/3 "2025-10-11T15:15:41Z")

</div>

> [@Frog](#):
>
> NBXplorer container

This is the error I am getting after reinstallation:

info: Configuration: NBXplorer version 2.5.28  
info: Configuration: Data Directory: /data  
info: Configuration: Configuration File: /data/Main/settings.config  
info: Configuration: Network: Mainnet  
Unhandled exception. System.FormatException: Invalid IP or DNS endpoint  
at NBitcoin.Utils.ParseEndpoint(String hostPort, Int32 defaultPort)  
at NBXplorer.Configuration.ExplorerConfiguration.LoadArgs(IConfiguration config) in /source/NBXplorer/Configuration/ExplorerConfiguration.cs:line 124  
at NBXplorer.Program.Main(String args) in /source/NBXplorer/Program.cs:line 34

---

<div class="post-metadata">

**Author:** ![Lastgameforlife](https://avatars.discourse-cdn.com/v4/letter/l/b782af/32.png) [@Lastgameforlife](https://community.umbrel.com/u/Lastgameforlife)\
**Post date:** [October 17, 2025, 12:29am UTC](https://community.umbrel.com/t/btcpayserver-btc-chain-not-syncing-after-update/24013/4 "2025-10-17T00:29:48Z")

</div>

I notice you are running umbrelOS 0.5.4, one of the the first suggestions I can make that might help is to update to a more recent version of umbrelOS.

Otherwise could you try what this comment suggested fir a similar issue? [BTCPAY won't start after install - #2 by usernameisJim](https://community.umbrel.com/t/btcpay-wont-start-after-install/10231/2)

Failing that, could you post the full logs of BTCPayServer? I’m not sure how to get it on your version but on newer versions of umbrelOS it’s Settings \> Troubleshoot \> App \> BTCPayServer

---

<div class="post-metadata">

**Author:** ![Frog](https://avatars.discourse-cdn.com/v4/letter/f/9fc29f/32.png) [@Frog](https://community.umbrel.com/u/Frog)\
**Post date:** [October 21, 2025, 7:03pm UTC](https://community.umbrel.com/t/btcpayserver-btc-chain-not-syncing-after-update/24013/5 "2025-10-21T19:03:56Z")

</div>

Thank you very much for hints. I have tried usernameisJim solution, it did not make the service running, even script reported restart is completed.

umbrel@umbrel:~/umbrel/scripts $ ./app restart btcpay-server  
Stopping app btcpay-server…  
Stopping btcpay-server\_nbxplorer\_1 … done  
Stopping btcpay-server\_postgres\_1 … done  
Stopping btcpay-server\_app\_proxy\_1 … done  
Stopping btcpay-server\_tor\_server\_1 … done  
Going to remove btcpay-server\_web\_1, btcpay-server\_nbxplorer\_1, btcpay-server\_postgres\_1, btcpay-server\_app\_proxy\_1, btcpay-server\_tor\_server\_1  
Removing btcpay-server\_web\_1 … done  
Removing btcpay-server\_nbxplorer\_1 … done  
Removing btcpay-server\_postgres\_1 … done  
Removing btcpay-server\_app\_proxy\_1 … done  
Removing btcpay-server\_tor\_server\_1 … done  
Starting app btcpay-server…  
Creating btcpay-server\_postgres\_1 … done  
Creating btcpay-server\_tor\_server\_1 … done  
Creating btcpay-server\_app\_proxy\_1 … done  
Creating btcpay-server\_nbxplorer\_1 … done  
Creating btcpay-server\_web\_1 … done

Attaching logs for further troubleshooting.

[umbrel-1761073089558-debug.log](https://community.umbrel.com/uploads/short-url/oush4gkJ2YiKsBjIMT7SwHkdU0v.log) (54.2 KB)
