Step 1 — Open Providers
From the dashboard, go to Configuration → Providers (/dashboard/configuration/providers) and click Add Provider.
Step 2 — Pick a preset
Guardway ships with presets for the most common providers. The preset pre-fills the base URL, headers, and any provider-specific quirks.Custom (OpenAI-compatible)
Step 3 — Fill in the form
| Field | Required | Notes |
|---|---|---|
| Provider type | Yes | The preset. Defines the adapter. |
| Display name | Yes | What you’ll see in lists and logs. |
| API key | Usually | Encrypted at rest. Required by most presets. Not required by local ones (Ollama, LM Studio). |
| Base URL | Prefilled | Editable for Custom and for presets with regional endpoints (Azure, Bedrock). |
| API version | Optional | Azure OpenAI and a few others. |
| Custom headers | Optional | For endpoints that require a routing header. |
Step 4 — Attach to a gateway
After saving, the provider appears in the list with health status Unknown until you attach it to a gateway. Click Attach and pick one or more gateways — each attached gateway gets its own copy of the credentials and reports health independently.
- Health: healthy, degraded, down, or unknown
- Latency: rolling p50 to the provider
- Models: count discovered (zero until you sync, see next page)
- Enabled: toggle to disable routing to this provider without deleting it
Next step
Sync models
With the provider attached, discover the models it exposes and enable the ones you want.