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

# Troubleshooting

> Common issues and fixes for deployment operations

## Troubleshooting Flow

```mermaid theme={null}
flowchart TD
    A[Issue Detected] --> B{Where is it failing?}
    B -->|Creation| C[Check model, cluster, and runtime inputs]
    B -->|Runtime| D[Inspect General and Workers status]
    B -->|Policy| E[Review Settings: limits, retries, fallback]
    B -->|Publication| F[Verify publish inputs and permissions]
    C --> G[Re-run action]
    D --> G
    E --> G
    F --> G
```

## Creation Issues

### Deployment fails to start

* Validate model source and cluster availability.
* Ensure all required runtime fields are provided.
* Confirm you have deployment manage permissions.

## Runtime Issues

### Deployment appears unhealthy

* Check status and metadata on the General tab.
* For local deployments, inspect Workers for inactive or failing nodes.
* Scale workers or adjust runtime settings as needed.

## Settings and Reliability Issues

### Requests are being throttled unexpectedly

* Re-check rate limit algorithm and quota thresholds.
* Confirm burst configuration matches traffic pattern.

### Frequent request failures

* Increase retry tolerance where appropriate.
* Add or validate fallback deployment chains.

## Publish and Access Issues

### Unable to publish endpoint

* Confirm deployment is active.
* Check permission scope for publish actions.
* Verify pricing fields are valid and complete.
* Confirm you are publishing for Customer Dashboard portal visibility (not for internal endpoint usage).

### Consumers cannot integrate successfully

* Regenerate snippets from **Use this model**.
* Confirm the deployment is active (publish is not required for internal API calls).
* Validate endpoint selection and environment assumptions.

## Still Need Help?

If issue persist, collect deployment name, project ID, action attempted, timestamp, and screenshots/log excerpts from the failing page state. Share these details with your platform administrator or support channel.