System Management

Update

Update HashCore Proxy to a new version via git pull and rebuilding Docker images.

We recommend watching the HashCore Proxy repository on GitHub to get notified about new releases.

Go to the project folder:
```
cd /opt/stratum-proxy
```
Stop the services:
```
docker compose down
```
Pull the latest changes:
```
git pull
```
Download updated images:
```
docker compose pull
```
Risk of monitoring data loss
Grafana and Prometheus use the latest tag — an update may trigger a major version upgrade incompatible with existing volume data. Before this step, make sure you don't need the accumulated monitoring data, or create a volume backup. If monitoring stops working after the update, see the Troubleshooting section.
Start services with updates:
```
docker compose up -d
```

How to Avoid Monitoring Data Loss

Pin the versions of Grafana and Prometheus in docker-compose.yml instead of using the latest tag:

image: prom/prometheus:v2.53.0
image: grafana/grafana:11.1.0

With this approach, docker compose pull will not upgrade to major versions. Update versions manually after checking compatibility in the official Prometheus and Grafana release notes.

Configuration Migration

When upgrading from stratum-proxy versions below 1.2.0:

Rename the configuration file farm-proxy.yaml to stratum-proxy.yaml.
Update the ports in stratum-proxy.yaml according to the new schema.

Stop

Stop all HashCore Proxy services via Docker Compose.

Uninstall

Complete removal of HashCore Proxy — stop containers, delete volumes, and remove the project folder.