Skip to content

FAQ: The system reports "Unable to connect to the server" ​

You may see the following messages when accessing the system. If the system worked previously and neither the server IP address nor the firewall settings have changed, one or more backend components may be offline.

Browser cannot reach the system site

Web page reports that it cannot connect to the server

The cause may be a system restart, an upgrade of Docker-related system components, or an unexpected restart of the Docker service. Run the following command to list the containers on the host. In the example below, the xpan-api container is offline.

bash
# Docker version v20 or later
docker ps -a --format "table {{.ID}}\t{{.Names}}\t{{.Networks}}\t{{.State}}\t{{.Ports}}"
============================================================================
CONTAINER ID   NAMES             NETWORKS   STATE     PORTS
6598105115a4   xpan-gw           xpan       running   0.0.0.0:80->80/tcp
7155c4009d1e   xpan-ota          xpan       running   80/tcp
2b66080ce1b9   xpan-fe           xpan       running   80/tcp
10863d1ff3b7   xpan-api          xpan       exited   80/tcp
59b268b9d37d   xpan-db           xpan       running   0.0.0.0:5432->5432/tcp

# Other Docker versions
docker ps -a

Bring the containers back online with the xpc tool (see Linux server operations / CLI tools):

bash
sudo bash /opt/xpan/tools/xpc.sh up
============ Terminal output ===============
丰盘 Ops Assistant: v1.2.2+220901
System operations guide: https://www.ekbcloud.com/docs/admin_manual/linuxop.html
xpan-ota
The system OTA service container xpan-ota started successfully.
...
All system component containers are online.