Dex Hub
Orchestrator — queue, dashboard, audit
Dex Hub is the control plane of the DexSuite. It accepts jobs from Dex Editor, queues them by priority, executes them in parallel (configurable), and shows the real-time state of every run.
Integrated scripting editor: write small Python or PowerShell scripts directly from the browser, saved in the scripts folder and categorized by maturity (online / experimental / deprecated). Each script can be launched on demand with a click, or scheduled with a cron-like expression (e.g. every night at 03:00, every 15 minutes, on the 1st of every month). Live stdout/stderr streaming, automatic retries, and notifications on failure.
Chains: define a sequence of operations (jobs and/or scripts) executed in order, with conditional branching on outcome (e.g. "if step 2 fails → send Telegram alert and stop; if it passes → step 3"). Chains can be scheduled as a single block and are the way to orchestrate composite workflows without external scripting.
Also includes a metrics dashboard, a cryptographic audit-ledger shared across the 4 apps, multi-channel notifiers (Telegram, Discord, email, webhook), bulk operations on failed jobs, full-text log search, and a public status page for clients. Designed as the single IT cockpit for a small business.
Features
- Priority job queue (no preemption)
- Job grouping: parallel + automatic join
- Integrated scripting: web editor for Python and PowerShell
- Script categorization: online / experimental / deprecated
- On-demand script execution from the browser with one click
- Cron-like scheduling for scripts, jobs and chains
- Chains: job/script sequences with conditional branching (success/failure)
- Running page with live stdout/stderr stream
- Real-time metrics dashboard
- Shared cryptographic audit-ledger
- Telegram, Discord, Email, outgoing Webhook notifiers
- Bulk operations on failed jobs (retry, cancel, requeue)
- Full-text log search
- Public status page at /status.html (no auth)
- MCP federation with Dex Editor / Dex Assistant / Net Inventory Suite
- Single Sign-On via DexAuth: delegated authentication, federated cookie, JIT user provisioning
- HTTPS with certificate (TLS) for secure UI and API access
- Responsive UI: mobile / tablet / desktop
Configuration
- HTTP port (default 3001)
- DB engine: sqlite | postgres | mariadb
- MAX_CONCURRENT_JOBS — execution concurrency
- SCRIPTS_DIR — user scripts folder
- PYTHON_CMD — Python interpreter to use (default `python`)
- Per-category script folders: SCRIPTS_ONLINE / SCRIPTS_EXPERIMENTAL / SCRIPTS_DEPRECATED
- Cron expression for script / job / chain scheduling
- Chain definition (step sequence + success/failure conditions)
- Telegram token + chat_id, Discord webhook, SMTP for email
- Alert thresholds (fail count, error rate)
- Log retention (days)
- Dex Editor / Dex Assistant / Net Inventory Suite URLs (MCP federation)
- DEXAUTH_URL — Identity Provider (DexAuth) endpoint for SSO
- HTTPS_CERT_PATH / HTTPS_KEY_PATH to enable TLS (port 443 or custom)
Technical prerequisites
- Node.js 20+
- SQL DB: SQLite (bundled) or PostgreSQL 14+ / MariaDB 10.6+
- Running Dex Editor (to receive jobs)
- Dex Assistant — optional, for integrated AI chat