BerriAI/litellm · error · RuntimeError

Database not connected. Connect a database to your proxy - h

Error message

Database not connected. Connect a database to your proxy - https://docs.litellm.ai/docs/simple_proxy#managing-auth---virtual-keys

What it means

Error "Database not connected. Connect a database to your proxy - https://docs.litellm.ai/docs/simple_proxy#managing-auth---virtual-keys" thrown in BerriAI/litellm.

Source

Thrown at litellm/integrations/focus/database.py:18

"""Database access helpers for Focus export."""

from __future__ import annotations

from datetime import datetime
from typing import Any, Final

import polars as pl


class FocusLiteLLMDatabase:
    """Retrieves LiteLLM usage data for Focus export workflows."""

    def _ensure_prisma_client(self):
        from litellm.proxy.proxy_server import prisma_client

        if prisma_client is None:
            raise RuntimeError(
                "Database not connected. Connect a database to your proxy - "
                "https://docs.litellm.ai/docs/simple_proxy#managing-auth---virtual-keys"
            )
        return prisma_client

    async def get_usage_data(
        self,
        *,
        limit: int | None = None,
        start_time_utc: datetime | None = None,
        end_time_utc: datetime | None = None,
    ) -> pl.DataFrame:
        """Return usage data for the requested window."""
        client: Final = self._ensure_prisma_client()

        where_clauses: Final[list[str]] = []
        query_params: Final[list[Any]] = []
        placeholder_index = 1

View on GitHub (pinned to 6c2dcb801b)

Solutions

1. Connect a database to the proxy (set DATABASE_URL) to enable Focus usage export.

When it happens

Trigger: Thrown at litellm/integrations/focus/database.py:18 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@6c2dcb801b (2026-08-15). Data as JSON: /api/errors/851c53f6ba75c330. Report an issue: GitHub.