Skip to main content

Architecture

Phoenix running on your virtual private cloud

Phoenix is a containerized application designed to collect and analyze traces from your LLM or AI application. It operates with a SQL database backend and provides a robust tracing UI. By default, Phoenix uses SQLite for storage, but it can be configured to use PostgreSQL for production deployments.

SQLite

By default, Phoenix uses SQLite, storing data in ~/.phoenix/ or the directory specified by the PHOENIX_WORKING_DIR environment variable. This allows for simple deployments using a volume mount, making it easy to get started without additional database setup.

PostgreSQL

For production and scalable deployments, Phoenix supports PostgreSQL. Configure the PHOENIX_SQL_DATABASE_URL environment variable to connect Phoenix to your PostgreSQL instance.
See the SQLite and PostgreSQL sections for details.

Deployment Options

Phoenix can be deployed using several methods, including Docker and Kubernetes. Choose the option that best fits your infrastructure and operational requirements.
For other ways to run Phoenix, including Phoenix Cloud, see Phoenix Deployments.

Configure Phoenix

Setup Authentication

Images

This table lists the images we publish that can be used to run Phoenix.
Image TagDescription
arizephoenix/phoenix:latestLatest released version of Phoenix using root permissions.
arizephoenix/phoenix:latest-nonrootLatest released version of Phoenix using nonroot permissions. Ensure the image has the required filesystem permissions before using.
arizephoenix/phoenix:latest-debugLatest released version of Phoenix using a debug base image.
arizephoenix/phoenix:version-X.X.XBuild for a specific release version using root permissions.
arizephoenix/phoenix:version-X.X.X-nonrootBuild for a specific release version using nonroot permissions.
arizephoenix/phoenix:version-X.X.X-debugBuild for a specific release version using a debug image.