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

  1. In your workspace, open Compute → Apps → Create App, choose Custom, name it (e.g. prometheux), and wait until it is Active.
  2. 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
  3. Click Deploy.
Source code path must be src (the app.yaml manifest lives there). Leaving it empty causes “No command to run and no Python file found”.
Your app will be available at 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.
The Prometheux Engine is provisioned by Prometheux. If your workspace isn’t yet enabled, request access from the app’s Installation tab or at support@prometheux.ai.
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