Self-Hosting
How to self-host a Phoenix instance
Last updated
Was this helpful?
How to self-host a Phoenix instance
Last updated
Was this helpful?
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.
By default, Phoenix uses SQLite mounted in ~/.phoenix/ or the directory specified by the PHOENIX_WORKING_DIR environment variable.
Phoenix can be configured to use PostgreSQL using the PHOENIX_SQL_DATABASE_URL environment variable.
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.
See available ports to run Phoenix
Customize Phoenix using environment variables
Setup authentication
Configuring OAuth2 identity providers
This table lists the images we publish that can be used to run Phoenix.
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.
You can deploy Phoenix on any cloud provider or on-premise. Here are some services that Phoenix can be deployed on:
AWS (also with CloudFormation)
Azure
GCP
LocalHost
Notebook
Docker / Kubernetes
