Update
It is recommended to follow the HashCore Proxy repository on Github to receive notifications about new releases. If you have made any changes to the configuration files, it is recommended to save them in a backup folder before updating.
- Navigate to the project folder:
cd /opt/stratum-proxy
- Stop the services:
docker compose down
- Pull changes from the repository:
git pull
- Download updated images:
docker compose pull
⚠️ Risk of monitoring data loss. Grafana and Prometheus use the
latesttag — an update may result in a major version transition (e.g., Prometheus v2→v3), which is incompatible with existing data in volumes. Before this step, ensure that the accumulated monitoring data is not needed, or back up the volumes. If monitoring stops working after the update — see section 9.1.
How to avoid the problem in the future: pin Grafana and Prometheus versions in
docker-compose.ymlinstead of thelatesttag. More details — in the section below.
- Start the services with updates:
docker compose up -d
Migration
When updating from stratum-proxy versions below 1.2.0, the following steps must be performed:
- Rename the configuration file
farm-proxy.yamltostratum-proxy.yaml - In the
stratum-proxy.yamlfile, update the ports according to the new scheme
How to avoid monitoring data loss
If historical monitoring data is important, pin Grafana and Prometheus versions in docker-compose.yml instead of the latest tag. For example:
image: prom/prometheus:v2.53.0
image: grafana/grafana:11.1.0
With this approach, docker compose pull will not update images beyond the specified version, and a major transition will not occur. Update versions manually — after checking compatibility in the official Prometheus and Grafana release notes.