# Troubleshooting

![Troubleshooting Hero](https://2482032708-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgdyIFgzKmiqf6iFTIQmE%2Fuploads%2Fgit-blob-f231b8f4539848a51a46becd62082b245efd0b75%2Fhero-troubleshooting.svg?alt=media)

This section provides issue-focused diagnosis and recovery steps.

## When to use this

Use this when behavior deviates from expected output or workflows fail.

## Step-by-step

1. Identify failing module and exact symptom.
2. Reproduce once with current date/time noted.
3. Use the matching troubleshooting page.
4. Validate fix in target module.
5. Escalate if the issue persists after all checks.

## Common mistakes

* Applying random fixes without identifying root symptom.
* Reconnecting integrations without verifying selected account/property.
* Ignoring environment-specific runtime configuration.

## Related pages

* [Features](https://docs.fopos.net/features)
* [FAQ](https://docs.fopos.net/faq)
* [Release Notes](https://docs.fopos.net/release-notes)