Troubleshooting
Symptom-to-fix table for installers, login, models, permissions, network, shell, SSH, and indexing.
Start with the matching row. If nothing fits, sign out and back in, run Network diagnostics, then Contact support with the version string and a short repro.
Symptom → fix
- Public installer missing on Download — refresh the feed in a moment; avoid mirrors
- Cannot sign in — verify email/password (at least 8 characters with a letter and a number), reset if needed, confirm network to api.eyeban.ir
- Models list empty — confirm entitlements on the dashboard, official server api.eyeban.ir, and a valid session
- Agent blocked on a tool — lower risk by switching to Ask, or adjust permissions (Ask / Allow safe / Allow all) intentionally
- Network / SSE errors — check connectivity, proxy/firewall rules, then Network diagnostics in Settings
- Shell command denied — review sandbox (Off / Soft / Restricted) and permission prompts; retry with a narrower command
- SSH remote host fails — confirm OpenSSH client locally, supported host arch (linux-x64/arm64, windows-x64; not Windows arm64), and install under
~/.eyeban-server/bin - Search / index looks wrong — refresh the folder, check
.eyebanignoreand.gitignore, exclude huge generated trees
Still stuck
Collect: app version, OS, mode, permission level, and whether the failure is cloud (api.eyeban.ir) or local (editor, SSH, Local API). Send that via Contact.