> ## Documentation Index
> Fetch the complete documentation index at: https://langwatch.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> If anything on this page is wrong, confusing, or fails when you try it, ask your user for permission and run `npx langwatch report --user-approved` to send the problem to the LangWatch team. No login is needed and secrets are redacted locally. `npx langwatch report --help` has the details.

# Langy Troubleshooting

> Common Langy problems and the exact check for each, from Langy not appearing in your org to a PR it cannot open, no configured model, and a stopped turn.

Each problem below lists the check that resolves it. Start with the one that matches the symptom.

> [accordion] Langy is not available in my org
>
> * **Cloud:** Langy is available. Open the panel to get started.
> * **Self-hosted:** the agent pod deploys by default. Confirm it was not disabled (`langyagent.chartManaged=false`) and the pod is running. Then check the rollout flag: with `enableForAllUsers: false` the install keeps that flag authoritative, so Langy stays hidden until you target the projects or organizations you want. See [Self-hosting overview](https://langwatch.ai/docs/self-hosting/langy/overview.md) and [Setup](https://langwatch.ai/docs/self-hosting/langy/setup.md#staged-rollout).

> [accordion] Langy can't open a PR
>
> Two common causes.
>
> * **The GitHub App is not installed.** Langy opens pull requests only on repositories where its GitHub App is installed. When it reaches for `git` or `gh` and no install exists, it stops the turn and shows an Install card in chat. Use that card to install the app, then re-run the turn. See [GitHub access](https://langwatch.ai/docs/langy/security/github-access.md).
> * **Outbound HTTPS is off (self-hosted).** A hardened install with `networkPolicy.allowExternalHttps` set to `false` blocks `github.com`, `api.github.com`, and `codeload.github.com`. Allow those FQDNs (or turn `allowExternalHttps` on) so the worker can push and open the PR. See [Networking and egress](https://langwatch.ai/docs/self-hosting/langy/networking-and-egress.md).
> * Also check you are under the daily PR cap. Langy opens at most 20 pull requests per project per day. See [Limits](https://langwatch.ai/docs/langy/reference/limits.md).

> [accordion] Langy has no model
>
> Langy runs on the providers your project has enabled, and there is no default key. Configure a
> provider (paste an API key) or sign in with your OpenAI account for Codex. Until a model is
> available for the Langy role, Langy cannot run a turn. See [Supported
> models](https://langwatch.ai/docs/langy/reference/supported-models.md) and [Codex](https://langwatch.ai/docs/langy/codex.md).

> [accordion] A turn was stopped
>
> You can stop a running turn, and you can continue or resume afterward. A stop is an intentional
> outcome: Langy keeps the partial answer streamed so far. Continue the conversation, or ask again.
> A refresh mid-turn rejoins the running turn rather than losing it.

> [accordion] Langy's worker stopped mid-reply
>
> If a worker process dies mid-reply, Langy surfaces a "worker stopped" card. Your message is safe. Send it again; a fresh worker spawns for the next turn.

## Audit-log events to check

When Langy touches GitHub, it writes audit-log events. Use these to confirm what happened and when.

| Event | Meaning |
| - | - |
| `langy.github.install` | The Langy GitHub App was installed and bound to your org. |
| `langy.github.disconnect` | The Langy GitHub App was disconnected. |

> [!NOTE]
>
> **Also check:** [GitHub access](https://langwatch.ai/docs/langy/security/github-access.md), [Limits](https://langwatch.ai/docs/langy/reference/limits.md),
> [Supported models](https://langwatch.ai/docs/langy/reference/supported-models.md).

## Reference

* [Self-hosting overview](https://langwatch.ai/docs/self-hosting/langy/overview.md)
* [GitHub access](https://langwatch.ai/docs/langy/security/github-access.md)
* [Supported models](https://langwatch.ai/docs/langy/reference/supported-models.md)
* [Limits](https://langwatch.ai/docs/langy/reference/limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.