Skip to main content

Documentation Index

Fetch the complete documentation index at: https://ray-preview.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

The Ray dashboard provides a browser-based view into a running cluster: node utilization, jobs, tasks, actors, and per-library views (Train, Tune, Serve, Data).

​
Default behavior

The head node serves the dashboard at http://<head-ip>:8265. Without configuration, the dashboard binds to localhost only.

​
Make it externally accessible

ray start --head --dashboard-host=0.0.0.0 --dashboard-port=8265
Only expose the dashboard to trusted networks. It allows arbitrary code submission via the Jobs API.

​
Authentication

The dashboard does not enforce authentication on its own. For production, put it behind a reverse proxy that handles auth (oauth2-proxy, Cloudflare Access, your platform’s ingress). On Kubernetes, see KubeRay auth for the supported integrations.

​
Forward the dashboard to localhost

ray dashboard ~/cluster.yaml
Forwards port 8265 from the cluster’s head to your local machine.

​
Disable the dashboard

ray start --head --include-dashboard=false
Useful in low-resource environments where the dashboard agent isn’t worth the overhead.

​
Metrics endpoint

The dashboard scrapes Prometheus metrics from each node at http://<node>:<metrics-port>/metrics. Configure your Prometheus instance to scrape these endpoints.

​
Next steps

Metrics

Cluster-wide Prometheus metrics.

Observability

Logs, profiling, and tracing.