# Troubleshooting

Find the failing layer and the relevant provider guide.

Source: https://faros.sh/docs/resources/troubleshooting/


## Start with these checks

| Symptom | Check first |
|---|---|
| Resources disappeared after switching context | Selected organization and workspace |
| Provider missing or disabled | [Enablement and dependencies](https://faros.sh/docs/use/workspaces/enable-provider/) |
| Access denied | [Memberships](https://faros.sh/docs/administration/members/) and the actual credential used |
| Provider unavailable | [Readiness and operator diagnostics](https://faros.sh/docs/self-hosting/hub/operations/) |
| Edge disconnected | [Edges troubleshooting](https://faros.sh/docs/use/edges/troubleshooting/) |
| Assistant cannot use a tool | [Tools, connections, and approvals](https://faros.sh/docs/use/agents/tools/) |

## Provider troubleshooting

- [App Studio](https://faros.sh/docs/use/app-studio/troubleshooting/)
- [AI agents](https://faros.sh/docs/use/agents/troubleshooting/)
- [Edges](https://faros.sh/docs/use/edges/troubleshooting/)
- [Infrastructure](https://faros.sh/docs/use/infrastructure/instances/#troubleshooting)
- [Code](https://faros.sh/docs/use/code/repositories/#troubleshooting)
- [Kuery](https://faros.sh/docs/use/kuery/quickstart/#troubleshooting)
- [Databricks](https://faros.sh/docs/use/databricks/troubleshooting/)

Record the resource, step, time, and request ID when asking for help. Exclude tokens and secrets. [Report a reproducible issue](https://github.com/faroshq/faros/issues).


## In this section