Deploy Prometheux as a native application in your Databricks workspace, on AWS, Azure, or GCP.
Overview
The Prometheux Databricks App is a lightweight frontend (a React UI served by a small Node.js proxy) that installs directly into your workspace.Prometheux Databricks App repository
github.com/prometheuxresearch/prometheux-databricks-3p-app
Your data and compute never leave Databricks. Your tables stay in Unity
Catalog under your governance, and all processing runs on your own Spark
clusters. Prometheux Cloud only handles orchestration, the structure and
definitions of your projects, and sign-in — it never stores your table data.
How it works
Deployment
Deploy via Git (recommended)
- In your workspace, open Compute → Apps → Create App, choose Custom,
name it (e.g.
prometheux), and wait until it is Active. - Click Deploy → From Git and fill in:
- Repository URL:
https://github.com/prometheuxresearch/prometheux-databricks-3p-app - Reference type: Branch · Git reference:
main - Source code path:
src
- Repository URL:
- Click Deploy.
https://prometheux-<workspace-id>.databricksapps.com.
To update, open the app and click Deploy again — Databricks pulls the latest
commit on main.
Deploy via Databricks CLI (alternative)
For environments that can’t reach GitHub from the workspace:Authentication
The app runs with authentication enabled. On first open, Prometheux signs the user in automatically using their Databricks identity (zero-click) — no passwords. Each Databricks workspace becomes its own Prometheux organization. A Prometheux administrator approves the first access request per user.Processing engine
Vadalog runs on your Spark clusters via the Prometheux Engine, installed as a cluster library, so compute happens next to your data. The app accesses your clusters and Unity Catalog tables through a Service Principal you configure in the app’s Databricks settings. See Installing PX on Databricks & Connectors for engine installation and connecting to Unity Catalog.Network egress
The app contacts only three hosts at runtime:
If your workspace restricts outbound traffic (e.g. a Serverless Egress Gateway),
allowlist the two
prometheux.ai hosts. No analytics, ad networks, CDN scripts,
or external secret stores are contacted.
Next Steps
- Installing PX on Databricks & Connectors — Install the engine and connect to Unity Catalog
- Concepts — Understand the core building blocks
- Python SDK — Connect to Prometheux programmatically

