chore(phoenix): switch to official helm chart (#926)

Co-authored-by: Jan Pokorný <[email protected]>

Author: jezekra1

apps/beeai-cli/src/beeai_cli/commands/platform.py

@@ -519,6 +519,20 @@ async def start(
 
         console.print("[green]BeeAI platform started successfully![/green]")
 
+        if any("phoenix.enabled=true" in value.lower() for value in set_values_list):
+            console.print(
+                textwrap.dedent("""\
+
+                License Notice:
+                When you enable Phoenix, be aware that Arize Phoenix is licensed under the Elastic License v2 (ELv2),
+                which has specific terms regarding commercial use and distribution. By enabling Phoenix, you acknowledge
+                that you are responsible for ensuring compliance with the ELv2 license terms for your specific use case.
+                Please review the Phoenix license (https://github.com/Arize-ai/phoenix/blob/main/LICENSE) before enabling
+                this feature in production environments.
+                """),
+                style="dim",
+            )
+
 
 @app.command("stop")
 async def stop(

apps/beeai-server/src/beeai_server/configuration.py

@@ -106,7 +106,7 @@ class VectorStoresConfiguration(BaseModel):
 
 
 class TelemetryConfiguration(BaseModel):
-    collector_url: AnyUrl = AnyUrl("http://otel-collector-svc:8335")
+    collector_url: AnyUrl = AnyUrl("http://otel-collector-svc:4318")
 
 
 class UIFeatureFlags(BaseModel):

apps/beeai-ui/.env.example

@@ -8,8 +8,8 @@ NEXT_PUBLIC_APP_NAME=
 # Default: '/bee.svg'
 NEXT_PUBLIC_APP_FAVICON_SVG=
 
-# Default: 'http://localhost:6006'
-NEXT_PUBLIC_PHOENIX_SERVER_TARGET='http://localhost:6006'
+# Default: 'http://localhost:31606'
+NEXT_PUBLIC_PHOENIX_SERVER_TARGET='http://localhost:31606'
 
 # Custom navigation structure in JSON format 
 # See ./src/modules/nav/schema.ts for the schema definition

apps/beeai-ui/src/utils/constants.ts

@@ -9,7 +9,7 @@ export const APP_NAME = process.env.NEXT_PUBLIC_APP_NAME ?? 'BeeAI';
 
 export const APP_FAVICON_SVG = process.env.NEXT_PUBLIC_APP_FAVICON_SVG ?? '/bee.svg';
 
-export const PHOENIX_SERVER_TARGET = process.env.NEXT_PUBLIC_PHOENIX_SERVER_TARGET ?? 'http://localhost:6006';
+export const PHOENIX_SERVER_TARGET = process.env.NEXT_PUBLIC_PHOENIX_SERVER_TARGET ?? 'http://localhost:31606';
 
 export const NAV_ITEMS = parseNav(process.env.NEXT_PUBLIC_NAV_ITEMS);
 

docs/concepts/agents.mdx

@@ -526,7 +526,7 @@ AGENT_MAX_TOKENS=2000
 AGENT_TEMPERATURE=0.7
 
 # Platform Integration
-OTEL_EXPORTER_OTLP_ENDPOINT=http://collector:8335
+OTEL_EXPORTER_OTLP_ENDPOINT=http://collector:4318
 PLATFORM_URL=http://beeai-platform:8333
 ```
 

docs/how-to/observe-agents.mdx

@@ -69,7 +69,7 @@ beeai platform start --set phoenix.enabled=true
    </Step>
     <Step title="Check if Phoenix is running">
         Spinning up phoenix can take a while, even after the `platform start` will report success.
-        Go to [http://localhost:6006](http://localhost:6006) and check if it's running. If not, please wait a few
+        Go to [http://localhost:31606](http://localhost:31606) and check if it's running. If not, please wait a few
         minutes or check your internet connection.
     </Step>
    <Step title="Run Agent with Phoenix Configuration">
@@ -82,7 +82,7 @@ beeai run chat "Hello"
 
    </Step>
    <Step title="View Traces in Phoenix">
-      Go to [http://localhost:6006](http://localhost:6006) in your browser and open the **default** project.
+      Go to [http://localhost:31606](http://localhost:31606) in your browser and open the **default** project.
    </Step>
 </Steps>
 

docs/observability/agents-traceability.mdx

@@ -30,7 +30,7 @@ beeai run chat "Hello"
 
    </Step>
    <Step title="View traces in Phoenix GUI">
-      Open http://localhost:6006 in your browser and navigate to the **default** project to explore the collected traces.
+      Open http://localhost:31606 in your browser and navigate to the **default** project to explore the collected traces.
    </Step>
 </Steps>
 

helm/Chart.lock

@@ -4,9 +4,12 @@ dependencies:
   version: 2.31.3
 - name: postgresql
   repository: oci://registry-1.docker.io/bitnamicharts
-  version: 16.7.12
+  version: 16.7.18
 - name: seaweedfs
   repository: https://seaweedfs.github.io/seaweedfs/helm
-  version: 4.0.391
-digest: sha256:97c422d16679a389494ec399dd4e4e57b1349a4f5360d50b8a06a17bac6cb69b
-generated: "2025-06-19T09:22:05.526278+02:00"
+  version: 4.0.393
+- name: phoenix-helm
+  repository: oci://registry-1.docker.io/arizephoenix
+  version: 2.0.11
+digest: sha256:7de8af83f584265cddb1bbef3ed03d70e3a52b508745b3ebc1007bc0eb77f911
+generated: "2025-07-15T14:31:35.503506+02:00"

helm/Chart.yaml

@@ -19,3 +19,9 @@ dependencies:
     name: seaweedfs
     repository: https://seaweedfs.github.io/seaweedfs/helm
     version: 4.x.x
+  - condition: phoenix.enabled
+    name: phoenix-helm
+    alias: phoenix
+    repository: oci://registry-1.docker.io/arizephoenix
+    version: 2.x.x
+

helm/templates/NOTES.txt

@@ -1,22 +1,62 @@
-1. Get the application URL by running these commands:
+Getting started:
 {{- if .Values.ingress.enabled }}
 {{- range $host := .Values.ingress.hosts }}
   {{- range .paths }}
   http{{ if $.Values.ingress.tls }}s{{ end }}://{{ $host.host }}{{ .path }}
   {{- end }}
 {{- end }}
 {{- else if contains "NodePort" .Values.service.type }}
+
   export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "beeai-platform.fullname" . }})
   export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}")
   echo http://$NODE_IP:$NODE_PORT
 {{- else if contains "LoadBalancer" .Values.service.type }}
+
      NOTE: It may take a few minutes for the LoadBalancer IP to be available.
-           You can watch its status by running 'kubectl get --namespace {{ .Release.Namespace }} svc -w {{ include "beeai-platform.fullname" . }}'
-  export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "beeai-platform.fullname" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
+           You can watch its status by running 'kubectl get --namespace {{ .Release.Namespace }} svc -w beeai-platform-svc'
+  export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} --beeai-platform-svc --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
   echo http://$SERVICE_IP:{{ .Values.service.port }}
 {{- else if contains "ClusterIP" .Values.service.type }}
-  export POD_NAME=$(kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "beeai-platform.name" . }},app.kubernetes.io/instance={{ .Release.Name }}" -o jsonpath="{.items[0].metadata.name}")
-  export CONTAINER_PORT=$(kubectl get pod --namespace {{ .Release.Namespace }} $POD_NAME -o jsonpath="{.spec.containers[0].ports[0].containerPort}")
-  echo "Visit http://127.0.0.1:8080 to use your application"
-  kubectl --namespace {{ .Release.Namespace }} port-forward $POD_NAME 8080:$CONTAINER_PORT
+
+    # port-forward the API
+    kubectl port-forward svc/beeai-platform-svc 8333:{{.Values.service.port}} &
+
+    # use the beeai CLI to setup the environment
+    {{- if .Values.auth.enabled }}
+    BEEAI__ADMIN_PASSWORD={{.Values.auth.admin_password}} beeai env setup
+    {{- else}}
+    beeai env setup
+    {{- end}}
+    {{- if .Values.ui.enabled }}
+
+    # port-forward the UI
+    kubectl port-forward svc/beeai-platform-ui-svc 8334:{{.Values.service.port}} &
+
+    # Open the UI in the browser
+    beeai ui
+    {{- end }}
+{{- end }}
+
+📄 See the documentation for more details and troubleshooting steps: https://docs.beeai.dev/deployment/kubernetes
+
+Resources:
+
+    📚 Documentation: https://docs.beeai.dev
+    🤖 Agent Catalog: https://beeai.dev/agents
+    💬 Discord Community: https://discord.gg/NradeA6ZNF
+    📝 GitHub Issues: https://github.com/i-am-bee/beeai-platform/issues
+
+Upgrade platform:
+
+    helm upgrade {{ .Release.Name }} oci://ghcr.io/i-am-bee/beeai-platform/beeai-platform-chart/beeai-platform:<version>
+
+{{- if .Values.phoenix.enabled }}
+
+Important License Notice:
+
+    When you enable Phoenix, be aware that Arize Phoenix is licensed under the Elastic License v2 (ELv2), which has
+    specific terms regarding commercial use and distribution. By enabling Phoenix, you acknowledge that you are
+    responsible for ensuring compliance with the ELv2 license terms for your specific use case. Please review the
+    Phoenix license (https://github.com/Arize-ai/phoenix/blob/main/LICENSE) before enabling this feature in
+    production environments.
 {{- end }}