Self-Hosting

How to self-host a Phoenix instance

Architecture

Phoenix running on your virtual private cloud

Phoenix runs as a containerized application backed by a SQL database that collects and analyzes OpenTelemetry traces from your LLM or AI application. By default, Phoenix is backed by SQLite, but it can also be configured to use PostgreSQL.

SQLite

By default, Phoenix uses SQLite mounted in ~/.phoenix/ or the directory specified by the PHOENIX_WORKING_DIR environment variable.

PostgreSQL

Phoenix can be configured to use PostgreSQL using the PHOENIX_SQL_DATABASE_URL environment variable.

See the SQLite and PostgreSQL sections of and for details.

Migrations

New major versions of Phoenix may contain database migrations that run automatically upon the start of the application. This process is intended to be seamless and should not require manual intervention except in exceptional circumstances.

Deployment Options

For other ways to run Phoenix, including Phoenix Cloud, see .

Docker

How to deploy Phoenix using Docker

Kubernetes

How to deploy Phoenix on K8S

Configure Phoenix

• See available ports to run Phoenix

• Customize Phoenix using environment variables

Setup Authentication

• Setup authentication

• Configuring OAuth2 identity providers

Images

This table lists the images we publish that can be used to run Phoenix.

Image Tag	Description
arizephoenix/phoenix:latest	Latest released version of Phoenix using root permissions.
arizephoenix/phoenix:latest-nonroot	Latest released version of Phoenix using nonroot permissions. Ensure the image has the required filesystem permissions before using.
arizephoenix/phoenix:latest-debug	Latest released version of Phoenix using a debug base image.
arizephoenix/phoenix:version-X.X.X	Build for a specific release version using root permissions.
arizephoenix/phoenix:version-X.X.X-nonroot	Build for a specific release version using nonroot permissions.
arizephoenix/phoenix:version-X.X.X-debug	Build for a specific release version using a debug image.

Services

You can deploy Phoenix on any cloud provider or on-premise. Here are some services that Phoenix can be deployed on:

Railway