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.

Reporting it #

Report a problem in the footer sends the operator what this page would otherwise ask you for: the versions, the machine's state, the last log lines, and the result you had open. Use it before writing anywhere else; the answer shows under Settings → Pool.

"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.

"Windows blocks SimulationCraft on this machine" #

The pool's simc is a fresh, unsigned build every time it moves, and Smart App Control (Windows 11) — or an app control policy your organisation set — refuses to run an unsigned program it has not seen before. The machine then lends nothing: the Lending line in Simhive's settings and the tray say so, and the pool sets it aside with that reason instead of dealing batches to it. Windows Security → Protection history names the policy and the file. Smart App Control cannot allow a single file: it is on or off, and off stays off (Windows Security → App & browser control → Smart App Control). A policy your organisation set is for its admin to change; the folder to allow is %APPDATA%\simhive\data\simc. Simhive checks again every five minutes and is back in the pool the moment the build runs. Nothing on the pool's side changes this, and an older build is no way out: every machine in the pool runs the same simc commit so that the numbers of one sim agree.

"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" #

Your sims go to the pool only while a machine with your token is connected. Without one the page sims in your browser tab instead — slower, and for smaller sims (Sim without lending); this message means the tab cannot: in Safari, or for a sim that needs the pool (Compare, Mythic+ routes, tank fights). Start Simhive (or your Docker container) on one of your machines; a minute later your sims run on the pool. 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.