---
title: "Troubleshooting"
description: "Start from the symptom and find the smallest safe recovery step."
canonical_url: "https://docs.linguana.dev/docs/troubleshooting"
markdown_url: "https://docs.linguana.dev/docs/troubleshooting.md"
x_farming_labs_generated_preamble: true
---

# Troubleshooting
URL: /docs/troubleshooting
LLM index: /llms.txt
Description: Start from the symptom and find the smallest safe recovery step.

# Troubleshooting

Keep the diagnostic code, job ID, and request ID. Do not paste source text, translations, project tokens, provider keys, or authorization headers into logs or support requests.

| Symptom | Guide |
| --- | --- |
| Manifest is empty or strict mode fails | [Build diagnostics](/docs/troubleshooting/build-diagnostics) |
| Upload returns 401, 403, or registration errors | [Upload and authentication](/docs/troubleshooting/upload-and-auth) |
| Job is stuck, capped, rejected, or timed out | [Jobs and provider](/docs/troubleshooting/jobs-and-provider) |
| Locale or catalog fails in the browser | [Catalog runtime](/docs/troubleshooting/catalog-runtime) |

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).