Install

Set up Trama for local development with Docker or a JVM-based run, then verify the API, readiness, and metrics endpoints. This is the fastest path from “what is Trama?” to “I have it running.”

Best for first-time users Activation guide Local setup

APISend a first workflow request after install. ExamplesUse sample definitions and inline runs. ConfigurationTune runtime and infrastructure settings.

Quick Start with Docker

docker compose up --build

This starts Postgres, Redis, the orchestrator and the management UI. The API is reachable at http://localhost:9080 and the UI at http://localhost:9000. This is the recommended first path for evaluation.

Verification Checklist

curl http://localhost:9080/healthz
curl http://localhost:9080/readyz
curl http://localhost:9080/metrics

Use port 8080 instead when running with ./gradlew run; the examples on this site use 8080.

Prerequisites

JDK 21
Postgres
Redis
Docker (optional, easiest path)

Run Locally

./gradlew run

The API listens on http://localhost:8080. Configure Postgres, Redis and the runtime in app/main/resources/application.yaml or through environment overrides.