Skip to main content

zigflow run

zigflow run​

Start the Zigflow workflow worker

Synopsis​

Start a Zigflow workflow worker that connects to Temporal and processes workflow executions defined in the provided workflow file.

The worker loads the workflow definition from the specified file, validates it (by default), and registers it with Temporal using the workflow's namespace as the task queue. The worker then polls Temporal for workflow and activity tasks until interrupted.

Use this command to deploy and run your Zigflow workflows in any environment, from local development to production.

zigflow run [flags]

Options​

      --cloudevents-config string       Path to CloudEvents config file
      --codec-endpoint string           Remote codec server endpoint
      --codec-headers stringToString    Remote codec server headers (default ***)
      --convert-data string             Data conversion mode: "", "aes", or "remote"
      --converter-key-path string       Path to conversion keys to encrypt Temporal data with AES (default "keys.yaml")
      --disable-telemetry               Disables all anonymous usage reporting. No telemetry data will be sent.
      --env-prefix string               Load envvars with this prefix to the workflow (default "ZIGGY")
  -f, --file string                     Path to workflow file
      --health-listen-address string    Address of health server (default "0.0.0.0:3000")
  -h, --help                            help for run
      --metrics-listen-address string   Address of Prometheus metrics server (default "0.0.0.0:9090")
      --metrics-prefix string           Prefix for metrics
  -H, --temporal-address string         Address of the Temporal server (default "localhost:7233")
      --temporal-api-key string         API key for Temporal authentication
  -n, --temporal-namespace string       Temporal namespace to use (default "default")
      --temporal-tls                    Enable TLS Temporal connection
      --tls-client-cert-path string     Path to mTLS client cert, usually ending in .pem
      --tls-client-key-path string      Path to mTLS client key, usually ending in .key
      --validate                        Run workflow validation (default true)

Options inherited from parent commands​

  -l, --log-level string   Set log level (default "info")

SEE ALSO​

  • zigflow - A Temporal DSL for turning declarative YAML into production-ready workflows
Auto generated by spf13/cobra on 20-Feb-2026​