Troubleshooting
Most problems have a one-line fix. Start with the list below.
Common problems
| Problem | Fix |
|---|---|
| A job stays Queued | Check runs-on. Every label must match, for example [self-hosted, codemany]. A typo keeps the job waiting. |
| Jobs wait a long time | Every machine is running as many jobs at once as it can. Jobs run when one finishes. To run more at once, add a machine. |
| Jobs stop when the Mac sleeps | Keep a laptop plugged in, or use an external display when the lid is closed. Low Power Mode also lets it sleep. |
| "Plan ended" or "Your trial has ended" | Choose Renew Plan… in the app (Plan & Billing). Jobs already running finish. |
| GitHub disconnected | Sign in to GitHub again in the app. Running jobs keep going; Codemany retries every 5 minutes. |
| "Low disk space" | Free up disk space. Each job needs about 15 GB, and Codemany keeps 20 GB free for the system. |
Check its health
In Terminal, run:
codemany doctor
It checks Codemany's background service, your plan, GitHub and the runners, and says what is wrong. In the app, open Settings › Troubleshooting (Linux: This machine › Troubleshooting). There you can restart the background service, Export Diagnostics…, Show App Logs in Finder, or choose Run Setup… to go through setup again. To set up with a GitHub token instead of signing in, paste it under GitHub token for setup.
Send Feedback
Choose Send Feedback… in the Codemany menu bar menu (Linux: the tray menu). It works even when you are signed out or Codemany's background service is down. You can also message @arpwal on X.