selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

temporal logo

Self-host temporal

v1.32.2

Durable workflow execution engine for crash-proof apps

ReleaseOpen SourceMIT
Docker ComposeCompose file & guide
docker compose up
Updated2 weeks ago
LanguageGo
Setup difficultyAdvanced
Stars
24 539
Ports
7233 (Frontend service gRPC endpoint (clients and workers connect here)), 7234 (History service gRPC endpoint), 7235 (Matching service gRPC endpoint), 7239 (Worker service gRPC endpoint), 7243 (Frontend service HTTP endpoint)
Docker
temporalio/server
temporal screenshot 1temporal screenshot 2temporal screenshot 3

What is temporal?

Temporal is the server behind the Temporal platform: a durable execution engine that runs application logic as Workflows, persisting their state so interrupted or failed operations are retried rather than lost. Workflows and Activities are written with an SDK (samples are provided for Go and Java), while this Go service handles scheduling, history and persistence. A deployment needs one supported database for state - Cassandra, MySQL or PostgreSQL, with SQLite limited to development - and Elasticsearch or OpenSearch is recommended as the Visibility store for listing and filtering Workflow Executions. You can run it with Docker Compose, the temporalio/server image, Helm charts on Kubernetes, or the release binaries plus the separate UI server binary; the Web UI and the temporal CLI are companion tools that talk to it. Self-hosting is MIT-licensed and production-documented, but note that Archival is still experimental and unavailable in Docker, and out of the box the Frontend API has no access control, so the docs treat the host like a database: private network, TLS/mTLS, and an authorizer plugin.

temporal alternatives

Should you self-host temporal?

temporal scores 82/100 on selfhost.directory (how scoring works) and ranks #1 of 1 in Workflow. It has 24 539 GitHub stars, +729 in the last 30 days.

It shipped 14 stable releases in the past year. The latest, v1.32.2, came out on 2 November 2026. New versions land roughly every 3 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is MIT-licensed and written mostly in Go.

Features

  • Archival to blob storageExperimental; disabled by default and not supported when running through Docker.
  • Durable workflow execution
  • Embedded server mode
  • gRPC API
  • Metrics and observability
  • mTLS encryption in transit
  • Multi-cluster replication
  • Namespace Isolation
  • Pluggable authorizationOff by default: the noopAuthorizer allows any request unless configured.
  • Temporal Nexus
  • Web UI
  • Workflow Visibility and search

temporal README

Temporal—durable execution platform

GitHub Release GitHub License Code Coverage Community Go Report Card

Introduction   •   Getting Started   •   Contributing   •   Temporal Docs   •   Temporal 101

Introduction

Temporal is a durable execution platform that enables developers to build scalable applications without sacrificing productivity or reliability. The Temporal server executes units of application logic called Workflows in a resilient manner that automatically handles intermittent failures, and retries failed operations.

Temporal is a mature technology that originated as a fork of Uber's Cadence. It is developed by Temporal Technologies, a startup by the creators of Cadence.

How to install temporal

Install temporal with Docker Compose

You have Docker Compose installed.
Environment variables
DB, DB_PORT, POSTGRES_USER, POSTGRES_PWD, POSTGRES_SEEDS, NUM_HISTORY_SHARDS, ENABLE_ES, ES_SEEDS, ES_VERSION, DYNAMIC_CONFIG_FILE_PATH
  1. Clone the temporalio/samples-server repository. The docker-compose.yml example uses the temporalio/server:${TEMPORAL_VERSION} image. This is what you need to use in your production environments and you can find a thorough list of configs here.

  2. Change into the compose directory.

    cd samples-server/compose
    
  3. Run the docker compose up command. This uses the default configuration from the docker-compose.yaml file, which includes a PostgreSQL database, an Elasticsearch instance, and exposes the Temporal gRPC Frontend on port 7233.

    docker compose up
    

The Temporal Web UI will be available at http://localhost:8080. With the temporalio/server image you manage schema updates manually using the temporalio/admin-tools image.

How to configure temporal

  • DBcassandraPersistence database type used for Workflow state.

    values: cassandra, mysql8, postgres12, postgres12_pgx

  • MYSQL_USERMySQL username.
  • MYSQL_PWDMySQL password.
  • MYSQL_SEEDSMySQL host for the persistence store.
  • POSTGRES_USERPostgreSQL username.

temporal releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…