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.

Docker

How to deploy Phoenix using Docker

Kubernetes

How to deploy Phoenix on K8S

Kubernetes (Helm)

Deploy Phoenix via Helm

AWS with CloudFormation

Deploy Phoenix on AWS Fargate using CloudFormation

Railway

Deploy Phoenix on Railway via a prebuilt template

​
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.