Getting started

1. Configure BIOS by following the below guides based on Mini PC model

   1. Beelink MINI S12 Pro (N100)
   2. Advantech P1571Z-C6 V2 (6650U)

2. Install latest Ubuntu Server 24.04 LTS by following this guide.

3. Run the bootstrap script to install or upgrade the stack:

   The script prepares the project in /home/coolblock/panel and keeps database dumps in /home/coolblock/panel/backup.

   curl -fsSL https://downloads.coolblock.com/panel/install.sh \
       | bash -s -- \
           --tank-model <tank_model> \
           --plc-model <plc_model> \
           --serial-number <serial_number> \
           --license-key <license_key> \
           --tunnel-jwt <tunnel_jwt> \
       | tee /root/install.log  # specify --headless argument if tank model does not support touch panel

   For PLC model compatibility, refer to the below table.

   Tank Model	PLC Model
   x110	Carel c.pCO mini (proto:modbus)
   x520	Siemens S7-1200 (proto:profinet)

4. Login with the default credentials

   MUST be changed afterwards Gear Icon -> Change Password and Gear Icon -> Change PIN

   Username	Password	PIN
   admin	admin123	1234

Administration

• Services lifecycle

  sudo systemctl start coolblock-panel.service  # to start the services
  sudo systemctl restart coolblock-panel.service  # to restart the services
  sudo systemctl stop coolblock-panel.service  # to stop the services

• Connecting to relational database

  # as coolblock user
  mysql --defaults-file=~/.my.cnf coolblock-panel

• Taking backups of relational database

  # as coolblock user
  cd panel/
  mysqldump --defaults-file=~/.my.cnf --databases coolblock-panel > adhoc-coolblock-panel_$(date +%Y%m%d_%H%M%S).sql

• Connecting to Panel (remotely)

  You will be prompted with username and password instead of PIN.

  Open your browser and navigate to https://panel-pc-ip-or-fqdn:10443.

• Connecting to time-series database (remotely)

  Login with username coolblock and the random generated password which can be found at DOCKER_INFLUXDB_INIT_PASSWORD variable in /home/coolblock/panel/.env file.

  Open your browser and navigate to https://panel-pc-ip-or-fqdn:8086.

Monitoring

The stack exposes a healthcheck endpoint at /backend/health that accepts an optional argument ?metrics=1 which will expose all services metrics for you. We highly recommend you to scrape/parse this endpoint (with zabbix/nagios etc..) in order to monitor multiple installations with ease.

Example healthcheck response with telemetry disabled:

{
  "redis": { "status": "healthy" },
  "database": {
    "influx": {
      "local": { "status": "healthy" },
      "cloud": { "status": "healthy" }
    },
    "mysql": { "status": "healthy" }
  },
  "panel": {
    "web": { "status": "healthy", "version": "0.9.9" },
    "api": { "status": "healthy", "version": "1.0.0" }
  },
  "internet": { "status": "healthy" },
  "latency": 442.908
}

Latency value is in ms

The healthcheck endpoint should reply with http status code 200 when redis, local influxdb, mysql and panel are healthy, otherwise it responds with a 5xx status code.

Troubleshooting

• Error response from daemon: Get "https://<subhost>.coolblock.com/v2/": dial tcp: lookup <subhost>.coolblock.com on <dns-ip>:53: no such host or Error response from daemon: unknown: failed to resolve reference "<subhost>.coolblock.com/coolblock/panel-<component>:<version>": unexpected status from HEAD request to https://<subhost>.coolblock.com/v2/coolblock/panel-<component>/manifests/<version>: 530 <none>

  You are probably using an older deployment file with references to our old container registry. As of 11-Nov-25, we' ve migrated our container images to GitHub.

  Running the below command, will fix the issue:

  sed -i \
      -e 's#registry.coolblock.com/coolblock/panel-web#ghcr.io/synapsecom/coolblock-panel-web#' \
      -e 's#registry.coolblock.com/coolblock/panel-api#ghcr.io/synapsecom/coolblock-panel-api#' \
      -e 's#registry.coolblock.com/coolblock/panel-proxy#ghcr.io/synapsecom/coolblock-panel-proxy#' \
      -e 's#registry.coolblock.com/coolblock/panel-tunnel#ghcr.io/synapsecom/coolblock-panel-tunnel#' \
      /home/coolblock/panel/docker-compose.yml
  
  sudo systemctl restart coolblock-panel.service

  Finally, you probably need to update your license key (aka. access token) by contacting your System Administrator.

• proxy-1 | 2025-11-11T20:13:17Z ERR Provider error, retrying in 2.018153525s error="Error response from daemon: client version 1.24 is too old. Minimum supported API version is 1.44, please upgrade your client to a newer version" providerName=docker

  There is a known bug for Docker version 29.0.0, see here. You can fix it by executing the below snippet:

  {
    echo "[Service]"
    echo "Environment=DOCKER_MIN_API_VERSION=1.24"
  } | sudo tee /etc/systemd/system/docker.service.d/override.conf
  
  sudo systemctl daemon-reload
  sudo systemctl restart docker