Troubleshooting

The messages Simhive shows when something is off, and what to do about each: unknown token, simc commit differs, not in the pool, an empty window, Docker pull errors, 0 it/s.

"rejected: unknown token" #

The token in the settings is not one this pool issued (a typo, or a token from another pool). Get a new one and paste it.

"simc commit differs … fetching" #

Normal after a nightly moves: the machine is fetching the pool's build and comes back on its own. Stuck for more than ten minutes: the Simhive panel's log says why (usually the download); it retries every ten minutes.

"not in the pool" / connecting… #

Simhive connects outbound to wss://simhive.app/worker on port 443. Nothing inbound, no port forwarding. A corporate proxy or a firewall that blocks WebSockets keeps it out. Reconnect in the panel after a network change.

The window is empty or says "starting the engine…" forever #

Quit from the tray and start again. Still stuck: the log at %APPDATA%\simhive\simhive.log (Linux: ~/.config/simhive/simhive.log) has the reason; send it to the operator.

Docker: "unauthorized" on pull #

The image is public and needs no login; docker logout ghcr.io clears a stale credential that gets in the way. "manifest unknown": your Docker is on ARM, and the image is x86-64 only.

Docker: the container restarts in a loop #

docker compose logs. Usually the token is missing from .env (the compose refuses to start without one) or the pool could not be reached to ask which SimulationCraft build to fetch; it retries by itself.

Web: "none of your machines is connected to the pool" #

The web interface sims only while a machine with your token is connected. Start Simhive (or your Docker container) on one of your machines; a minute later the page lets you sim. Paused counts as connected.

Everything says 0 it/s #

Speeds are measured on real batches, not guessed; after the first few sims the numbers fill in.

My PC is sluggish while it sims #

Lower the thread slider (leave two for yourself), or turn on "pause while World of Warcraft runs". Pause lending stops it at once.

The pool says my machine is "behind" #

A Simhive app updates from its tray (Update now). A Docker worker: docker compose pull && docker compose up -d.

Where are my settings and history? #

%APPDATA%\simhive\: settings.json, data\history, data\simc (the builds). Linux: ~/.config/simhive/. Uninstalling keeps them.