> For the complete documentation index, see [llms.txt](https://docs.serverlessapigateway.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.serverlessapigateway.com/troubleshooting.md). # Troubleshooting - [Deployment And Troubleshooting](https://docs.serverlessapigateway.com/troubleshooting/wrangler-deploy-guide.md): Use Wrangler for repeatable deployment of the worker, service modules, and bindings configuration. This guide covers the \`wrangler.toml\` fields relevant to the - [GitHub Actions Deploy Guide](https://docs.serverlessapigateway.com/troubleshooting/wrangler-deploy-guide/github-actions-deploy-guide.md): Automate deploys when you want config and docs checks to run before publishing the worker. This guide covers the GitHub Actions workflow structure, secrets - [Local Testing with Vitest](https://docs.serverlessapigateway.com/troubleshooting/wrangler-deploy-guide/local-testing-with-vitest.md): Use the existing unit and integration tests as the fastest confidence check for config and routing changes. The gateway repo uses Vitest for unit tests and - [Local E2E with unstable\_dev](https://docs.serverlessapigateway.com/troubleshooting/wrangler-deploy-guide/local-e2e-with-unstable-dev.md): Run local worker E2E tests when you need real runtime behavior instead of only module-level assertions. The \`unstable\_dev\` API starts a local Wrangler dev - [Docs Sync and Canonical Examples](https://docs.serverlessapigateway.com/troubleshooting/wrangler-deploy-guide/docs-sync-and-canonical-examples.md): Treat the checked-in config examples as the canonical source for both docs and automated checks. The gateway repo includes config examples that are used in both - [Debugging Upstream Failures](https://docs.serverlessapigateway.com/troubleshooting/wrangler-deploy-guide/upstream-failure-debugging.md): Use this guide when proxied routes fail and you need to isolate routing, auth, and upstream behavior. Start by checking whether the gateway matched the right - [Gateway Troubleshooting Matrix](https://docs.serverlessapigateway.com/troubleshooting/wrangler-deploy-guide/gateway-troubleshooting-matrix.md): Use the matrix to map common symptoms to the fastest next diagnostic step. This page lists symptoms like "route returns 404", "auth returns 401", "upstream --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.serverlessapigateway.com/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.