Troubleshooting
Identify the part that failed and collect the details needed to resolve it.
Updated 2026-09-15
Farero did not open
On the host, run farero to open the local app. If it remains unavailable, farero service status can establish whether the service is running. Note the exact installation or service error and the host platform.
Open Settings → Providers and read the affected provider's state. Complete any required authentication using that provider's flow on the host. Check the selected model as well: an installed executable does not establish access to every model.
Workspace preparation stopped
Read the setup status in the affected workspace. A repository path, missing Git credential, failed setup command, or unavailable source branch calls for a different fix. Keep the original task and its status together while Farero recovers; do not create repeated workspaces to work around an uncertain creation result.
The browser disconnected during a task
Return to the same conversation. A disconnected browser does not itself cancel the host's agent. Farero reconnects and reconciles saved state automatically. Read the current transcript and recovery status before sending another instruction.
If a send's outcome is uncertain, submitting it again can duplicate work. Follow the specific decision Farero requests after recovery; do not assume that missing output means the provider never received the prompt.
The phone cannot connect
Check that the host is online and both devices are connected to the intended tailnet. Use the private HTTPS connection from Farero. On Linux, the host's user must remain logged in. See Remote access for the connection model.
Voice cannot start
Check browser microphone permission, a secure origin, and the host's voice configuration. For remote calls use HTTPS. Record the displayed error rather than including credentials in a report.
Report what happened
Include the Farero version, host OS, affected provider, exact error, approximate time, and the smallest sequence that reproduces it. Say what you expected and what happened. Include relevant redacted logs or screenshots only; exclude tokens, QR codes, API keys, and private repository content.
Use the site's support destination when reporting a problem. An unresolved platform acceptance check is listed in Platform support and limitations.