---
title: "Configuration"
url: "/docs/proxy/configuration/overview"
canonical_url: "https://docs.litellm.ai/docs/proxy/configuration/overview"
type: "docs"
last_updated: "2026-11-12"
summary: "Choose YAML, the Admin UI, Management API, or Terraform to configure LiteLLM and manage models, teams, and virtual keys."
related:
  - "/docs/proxy/health"
  - "/docs/proxy/configs"
---
# Configuration

> Index of all LiteLLM docs: https://docs.litellm.ai/llms.txt


Configure the models LiteLLM serves, how it routes requests, and what teams and applications can access. Choose YAML, the Admin UI, the Management API, or Terraform below.

Start with a running gateway. The [deployment guides](../deploy.md) cover installation and infrastructure.

## Choose a method

**YAML**

### Keep settings in a file

Define models and gateway settings in `config.yaml`. Review changes in version control and load the file when LiteLLM starts. Use environment variables for credentials.

The [YAML guide](../configs.md) covers model definitions, routing, logging, and server settings. It links to the full settings reference, file management, and CLI options.

**UI**

### Make changes in the browser

Open the Admin UI to add models, create teams and virtual keys, and edit supported settings. The gateway stores these changes in its database.

The [UI guide](./ui.md) covers setup, common tasks, and which settings you can change when you also use YAML.

**Management API**

### Connect your internal platform

Call HTTP endpoints to register models, create teams and virtual keys, update access, and revoke keys. The gateway stores these resources in its database. Your platform can manage them without changes to a deployment file.

The [Management API guide](./api.md) shows how to register a self-hosted model and give an application access. It covers supported operations, where settings live, and when changes take effect.

**Terraform**

### Manage resources as code

Declare teams, virtual keys, models, and other supported resources in Terraform. Review the plan, then apply it through the gateway's API.

The [Terraform guide](./terraform.md) shows how to configure the LiteLLM provider, create a team, and import an existing team.

## Use more than one method

You can keep deployment settings in YAML and manage resources through the UI, Management API, or Terraform. Choose one place to maintain each setting or resource. Each method supports a set of operations. Check its guide and reference for the task you need.

From v1.103.0, YAML settings take priority over database values. The UI cannot change those settings. Models follow a different rule. The gateway serves models from the UI or API alongside YAML models. See [YAML and database settings](../configs.md#configyaml-vs-database-settings) for the affected sections, refresh behavior, and earlier versions.

For permissions, see [Access Management](../access_management/overview.md). For credentials and network controls, see [Security](../security/overview.md).

## Related pages

- [Health Checks](https://docs.litellm.ai/docs/proxy/health.md)
- [YAML](https://docs.litellm.ai/docs/proxy/configs.md)