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

# vLLM

> Integrate vLLM-hosted custom models with Prisma AIRS AI Gateway for production observability and reliability.

The AI Gateway provides a robust platform to observe, govern, and manage your **locally** or **privately** hosted custom models using vLLM.

> [!NOTE]
>
> Here's a [list](https://docs.vllm.ai/en/latest/models/supported_models.html) of all model architectures supported on vLLM.

## Integration Steps

**1. Expose your vLLM Server**

Expose your vLLM server using a tunneling service like [ngrok](https://ngrok.com/) or make it publicly accessible. Skip this if you're self-hosting the Gateway.

```sh theme={"system"}
ngrok http 8000 --host-header="localhost:8080"
```

**2. Add to Model Catalog**

1. Go to [**Model Catalog → Add Provider**](https://stratacloudmanager.paloaltonetworks.com/)
2. Enable **"Local/Privately hosted provider"** toggle
3. Select **OpenAI** as the provider type (vLLM follows OpenAI API schema)
4. Enter your vLLM server URL in **Custom Host**: `https://your-vllm-server.ngrok-free.app`
5. Add authentication headers if needed
6. Name your provider (e.g., `my-vllm`)

> **[Complete Setup Guide](https://docs.portkey.ai/docs/aigw/product/model-catalog.md)**
>
> See all setup options

**3. Use in Your Application**

**Or use custom host directly:**

> [!NOTE]
>
> **Important:** vLLM follows the OpenAI API specification, so set the provider as `openai` when using custom host directly. By default, vLLM runs on `http://localhost:8000/v1`.

***

## Next Steps

> **[Gateway Configs](https://docs.portkey.ai/docs/aigw/product/ai-gateway.md)**
>
> Add retries, timeouts, and fallbacks

> **[Observability](https://docs.portkey.ai/docs/aigw/product/observability.md)**
>
> Monitor your vLLM deployments

> **[Custom Host Guide](https://docs.portkey.ai/docs/aigw/product/ai-gateway/universal-api.md#integrating-local-or-private-models)**
>
> Learn more about custom host setup

> **[BYOLLM Guide](https://docs.portkey.ai/docs/aigw/integrations/llms/byollm.md)**
>
> Complete guide for private LLMs


## Related topics

- [Supported Providers](https://docs.portkey.ai/docs/aigw/api-reference/inference-api/supported-providers.md)


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