Temporal Development Environment

A simplified Docker Compose setup for running Temporal locally for development purposes.

Services Included

This Docker Compose setup includes the following services:

• PostgreSQL Database (temporal-postgresql) - Database backend for Temporal
• Temporal Server (temporal) - Core Temporal service with auto-setup
• Temporal Admin Tools (temporal-admin-tools) - Command-line tools for Temporal administration
• Temporal Web UI (temporal-ui) - Web interface for monitoring workflows and activities

Quick Start

1. Clone this repository

   git clone https://github.com/w95/temporal-docker-compose.git
   cd temporal-docker-compose

2. Start the services

   docker-compose up -d

3. Access the Temporal Web UI Open your browser and navigate to http://localhost:8080

4. Verify the setup Check that all services are running:

   docker-compose ps

Service Details

PostgreSQL Database

• Port: 5432
• Database: temporal
• Username: temporal
• Password: temporal

Temporal Server

• Port: 7233 (gRPC endpoint)
• Version: 1.28.0
• Auto-setup: Enabled (automatically initializes the database schema)

Temporal Web UI

• Port: 8080
• URL: http://localhost:8080
• Version: 2.34.0

Admin Tools

• Interactive container with Temporal CLI tools
• Access via: docker exec -it temporal-admin-tools bash

Configuration

Dynamic Configuration

The setup uses a custom dynamic configuration file located at temporal/development-sql.yaml. This file contains development-specific settings:

• Increased max ID length limit (255 characters)
• Forced search attributes cache refresh (development only)

Common Commands

Start services

docker-compose up -d

Stop services

docker-compose down

View logs

# All services
docker-compose logs -f

# Specific service
docker-compose logs -f temporal

Access admin tools

docker exec -it temporal-admin-tools bash

Connect to PostgreSQL

docker exec -it temporal-postgresql psql -U temporal -d temporal

Development Usage

Once the services are running, you can connect your Temporal client applications to:

• Temporal Server: localhost:7233
• Web UI: http://localhost:8080

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test the changes locally
5. Submit a pull request

Resources

• Temporal Documentation
• Temporal Samples
• Temporal Community
• Docker Compose Documentation