Deploy Prometheux on a single VM in AWS, Azure, GCP, or your own data centre using Docker Compose.

Overview

The single-node deployment runs the full Prometheux platform on one machine using Docker Compose. It takes minutes to set up and is the easiest way to run Prometheux on infrastructure you control. The deployment is fully containerised — no manual dependency installation, no complex networking, and no cluster management required.

What You Need

  • A Linux VM (or bare metal server) with Docker and Docker Compose installed
  • Minimum recommended hardware: 4 vCPUs, 16 GB RAM, 50 GB disk
  • An image pull token from the Prometheux team
Guided setupThe Prometheux team will walk you through the initial setup and provide your credentials. Book a call to get started.

How It Works

  1. Clone the deployment repository
  2. Add your token to a single configuration file
  3. Run one command to start the platform
That’s it. The script pulls the container images and starts all services automatically.

What Gets Deployed

All services run inside Docker containers and are fully managed by the provided scripts.

Supported Environments

The single-node deployment works on any machine that can run Docker:

Management

Simple scripts are provided for day-to-day operations:
Updating to a new version is just as simple — stop, pull the latest images, and restart.

Configuration

Engine configuration files are mounted from the host, making them easy to adjust. For the full list of available properties, see the Configuration Reference.

Next Steps

  • REST API — Interact with the engine programmatically
  • Python SDK — Use prometheux_chain from notebooks or scripts
  • Cluster deployment — Scale to distributed Yarn or Kubernetes clusters