Temporal

Server Commands

Run a local Temporal server for development with automatic Web UI, in-memory database, and namespace creation. Perfect for testing workflows without cloud infrastructure.

6 commands

Pro Tips

Use '--db-filename temporal.db' to persist workflows across server restarts.

Access the Web UI at http://localhost:8233 to visualize workflow executions.

Pre-register multiple namespaces at startup: 'temporal server start-dev --namespace foo --namespace bar'.

Common Mistakes

start-dev is NOT for production use. It skips security checks and uses in-memory storage by default.

Without --db-filename, all workflow data is lost when the server stops.

Commands

Start dev server

$ temporal server start-dev

Start local Temporal server with Web UI at localhost:8233.

Start with persistent DB

$ temporal server start-dev --db-filename temporal.db

Start server with SQLite persistence for state across restarts.

Start with custom namespaces

$ temporal server start-dev --namespace dev --namespace staging

Pre-register multiple namespaces at startup.

Start with custom ports

$ temporal server start-dev --port 7233 --ui-port 8233

Configure gRPC and Web UI ports.

Start headless (no UI)

$ temporal server start-dev --headless

Start server without Web UI.

Register search attributes

$ temporal server start-dev --search-attribute 'CustomField=Text'

Pre-register custom search attributes (Text, Keyword, Int, Double, Bool, Datetime, KeywordList).