Skip to main content

Troubleshooting

Common issues and how to fix them.

App won't open (macOS)​

Symptom: Double-clicking GenKaKu Worker shows "Apple cannot check it for malicious software."

Fix:

  1. Go to System Settings → Privacy & Security
  2. Scroll down to the Security section
  3. Click Open Anyway next to the GenKaKu Worker message
  4. Enter your password to confirm

"Worker Token Required" banner won't go away​

Symptom: You pasted a token but the banner persists.

Fix:

  • Make sure the token starts with cwt_
  • Check for extra spaces before or after the token
  • Try copying the token again from genkaku.app/settings → Worker tab
  • Click Save after pasting

"No worker token configured" error​

Symptom: Clicking "Connect & Start Earning" shows this error.

Fix:

  • The token was not saved. Paste your token in the input field and click Save
  • If the input field is not visible, click Reset next to the token indicator and re-enter

Ollama not running​

Symptom: The Ollama section shows "Installed, not running" or "Not installed."

Fix:

  1. If not installed: download from ollama.com and install
  2. If installed but not running: click Start in the Ollama section of the Dashboard
  3. If Start doesn't work: open a terminal and run ollama serve, then restart the Desktop App

GPU not detected​

Symptom: tok/s is very low (single digits) or GPU usage stays at 0%.

Fix:

  • macOS: Make sure you're on Apple Silicon (M1 or later). Intel Macs use CPU only.
  • NVIDIA: Install the latest GPU drivers. Check nvidia-smi in a terminal.
  • AMD: Install the latest Vulkan drivers.
  • Check that no other GPU-heavy tasks are running (games, video editing, other AI workloads).

Connect button doesn't work​

Symptom: Clicking "Connect & Start Earning" does nothing or shows an error.

Fix:

  1. Check your internet connection
  2. Make sure your token is valid — go to genkaku.app/settings → Worker tab to verify
  3. Try clicking Reset next to the token indicator and entering a fresh token
  4. Check if the server is online at genkaku.app

Worker connects but earns nothing​

Symptom: Status shows "Connected" but earnings don't increase.

Possible causes:

  • Low tok/s — if your GPU is too slow, the orchestrator may not route jobs to you. Check the tok/s reading in the Dashboard.
  • No demand — earnings depend on user activity. During low-traffic periods, there may be fewer jobs.
  • Network issues — unstable connection may cause jobs to time out before completion.
  • Ollama issues — make sure Ollama is running and the model is loaded.

Earnings not updating​

Symptom: You completed jobs but earnings show $0.

Fix:

  • Earnings update in real-time but may have a short delay (1-2 minutes)
  • Check the Desktop App and genkaku.app/settings → Worker tab
  • If earnings persist at $0 after several jobs, check the connection status

Token was shown once and I lost it​

Symptom: You generated a token but didn't save it.

Fix:

  • Go to genkaku.app/settings → Worker tab
  • Click Revoke on the old token
  • Click Generate Token to create a new one
  • Copy it immediately — it's only shown once

App crashes or freezes​

Symptom: The Desktop App stops responding.

Fix:

  1. Force quit the app (Cmd+Option+Esc on macOS, Task Manager on Windows)
  2. Make sure Ollama is still running (check Activity Monitor or Task Manager)
  3. Restart the Desktop App
  4. If the issue persists, try clearing the app's stored data:
    • macOS: delete ~/Library/Application Support/genkaku-worker/
    • Windows: delete %APPDATA%/genkaku-worker/

Multiple workers on one account​

Symptom: You want to run workers on multiple machines.

Allowed: Yes, you can run up to 10 workers per account and up to 10 workers per IP address.

To set up a second worker:

  1. Generate a new token at genkaku.app/settings → Worker tab
  2. Install the Desktop App on the second machine
  3. Paste the new token

Each worker gets its own token but all earnings go to the same account.

Still stuck?​

If none of the above fixes work:

  1. Check the GenKaKu Discord for known issues
  2. Report the bug at github.com/anomalyco/opencode/issues
  3. Include your OS version, GPU model, and the error message you see