Home
Available on AWS Marketplace

Temporal Server

Ubuntu 24.04 LTS | Production-Ready | Workflow Orchestration

Complete AMI guide for your Temporal Server deployment. Learn how to access the Web UI, connect via gRPC, create workflows, and configure your instance for production use.

Temporal 1.32.2 PostgreSQL Persistence Ubuntu 24.04 LTS

Quick Start Guide

Follow these steps to access your Temporal Server and start orchestrating workflows.

1

SSH to Your Instance

Connect to your EC2 instance using SSH with your key pair.

ssh -i your-key.pem ubuntu@<your-instance-ip>
2

Check Service Status

Verify that Temporal Server is running properly.

sudo systemctl status temporal
3

Access Web UI

Open the Temporal Web UI in your browser to monitor workflows.

http://<your-instance-ip>:8080

The Web UI provides a visual interface for monitoring workflows, activities, and task queues.

4

Connect via gRPC

Connect your workers and clients to Temporal using gRPC.

# gRPC endpoint <your-instance-ip>:7233 # Using tctl CLI tctl --address <your-instance-ip>:7233 cluster health

Temporal Web UI

Monitor and manage your workflows through the intuitive web interface.

Access Details

  • URL: http://<your-ip>:8080
  • Port: 8080
  • Protocol: HTTP (configure HTTPS via reverse proxy)

Web UI Features

  • View workflow executions and history
  • Monitor task queues and workers
  • Search and filter workflows
  • Terminate or signal running workflows

Connecting via gRPC

Connect your Temporal workers and clients using the gRPC API.

1

gRPC Endpoint

The Temporal Server listens for gRPC connections on port 7233.

# gRPC Frontend Service <your-instance-ip>:7233
2

Health Check

Verify the server is healthy using tctl or the health endpoint.

# HTTP health check curl http://<your-instance-ip>:7233/health # Using tctl tctl --address <your-instance-ip>:7233 cluster health
3

Go SDK Connection

Connect from your Go application using the Temporal SDK.

c, err := client.Dial(client.Options{ HostPort: "<your-instance-ip>:7233", })
4

Python SDK Connection

Connect from your Python application using the Temporal SDK.

client = await Client.connect( "<your-instance-ip>:7233" )

Creating Namespaces & Workflows

Learn how to create namespaces and manage workflows using the Temporal CLI.

Create a Namespace

Namespaces isolate workflows and provide multi-tenancy support.

# Create a new namespace tctl --address localhost:7233 \ --namespace my-namespace \ namespace register # List all namespaces tctl --address localhost:7233 namespace list

Start a Workflow

Execute workflows using tctl or the SDK.

# Start a workflow execution tctl --address localhost:7233 \ --namespace my-namespace \ workflow start \ --taskqueue my-task-queue \ --workflow_type MyWorkflow \ --workflow_id my-workflow-id

Common tctl Commands

List Workflows

View running and completed workflows in a namespace.

tctl workflow list

Describe Workflow

Get detailed information about a specific workflow.

tctl workflow describe -w id

Terminate Workflow

Force stop a running workflow execution.

tctl workflow terminate -w id

Signal Workflow

Send a signal to a running workflow.

tctl workflow signal -w id -n signal

Query Workflow

Query workflow state without affecting execution.

tctl workflow query -w id -qt type

Show History

View the complete event history of a workflow.

tctl workflow show -w id

Workflow Best Practices

  • Use meaningful workflow IDs for easier debugging and idempotency.
  • Create separate namespaces for different environments (dev, staging, prod).
  • Configure retention periods appropriate for your compliance requirements.
  • Use task queues to route workflows to specific worker pools.

Security & Firewall Configuration

Secure your Temporal deployment with proper firewall rules and best practices.

Important: By default, Temporal does not have authentication enabled. Restrict access using AWS Security Groups and consider enabling mTLS for production deployments.

Security Groups

Configure inbound rules to restrict access to trusted IPs only.

Port 7233 (gRPC)

Restrict to your application servers and worker instances.

Port 8080 (Web UI)

Restrict to admin IPs or use a reverse proxy with authentication.

Recommended Security Group Rules

Port Protocol Source Description
22 TCP Your IP SSH access
7233 TCP VPC CIDR / Worker IPs gRPC Frontend Service
8080 TCP Admin IPs Web UI

Production Security Recommendations

  • Enable mTLS for gRPC communication between clients and server.
  • Place the Web UI behind a reverse proxy (nginx/ALB) with HTTPS and authentication.
  • Use AWS VPC endpoints to keep traffic within your VPC.
  • Enable CloudWatch logging and monitoring for audit trails.

Troubleshooting

Common issues and how to resolve them.

Can't Connect to gRPC

Symptom: Connection refused or timeout when connecting to port 7233.

Solution:

  • 1. Check Security Group allows inbound on port 7233
  • 2. Verify Temporal is running: sudo systemctl status temporal
  • 3. Check service logs: sudo journalctl -u temporal -f

Web UI Not Loading

Symptom: Browser shows connection refused or timeout.

Solution:

  • 1. Check Security Group allows inbound on port 8080
  • 2. Verify UI service is running: sudo systemctl status temporal-ui
  • 3. Ensure you're using HTTP (not HTTPS) unless configured

Service Won't Start

Symptom: Temporal service fails to start or crashes.

Solution:

  • 1. Check logs: sudo journalctl -u temporal -n 100
  • 2. Verify PostgreSQL is running: sudo systemctl status postgresql
  • 3. Check disk space: df -h

Namespace Not Found

Symptom: "namespace not found" error when running workflows.

Solution:

  • 1. Register the namespace first:
  • tctl namespace register my-namespace
  • 2. List existing namespaces: tctl namespace list
  • 3. Note: the default namespace is default

Service Management

Common commands for managing the Temporal services.

Start/Stop Services

# Start Temporal sudo systemctl start temporal # Stop Temporal sudo systemctl stop temporal # Restart Temporal sudo systemctl restart temporal

View Logs

# View Temporal logs sudo journalctl -u temporal -f # View Web UI logs sudo journalctl -u temporal-ui -f # View last 100 lines sudo journalctl -u temporal -n 100

Need Help?

Our team is available 24/7 to assist you with any questions or issues.

support@flowopsconsulting.co.uk
24/7 Support Available