---

title: 'run' sidebar_label: 'run' pagination_prev: null pagination_next: null

Run Spice - starts the Spice runtime, installing if necessary.

spice run is a wrapper around the spiced runtime binary. It installs spiced on first use, applies developer-friendly defaults, and forwards arguments after -- to the runtime. To invoke the runtime directly (for containers, systemd units, or CI), see the spiced reference.

Usage

Flags

• -h, --help Print this help message.
• --endpoint Configure the runtime endpoint. The URL scheme determines the endpoint type: http:// or https:// sets the HTTP endpoint, grpc:// or grpc+tls:// sets the Flight endpoint. Cannot be combined with --http-endpoint or --flight-endpoint for the same endpoint type.
• --flight-endpoint Configure runtime Flight endpoint. Defaults to http://127.0.0.1:50051.
• --http-endpoint Configure runtime HTTP endpoint. Defaults to http://127.0.0.1:8090.
• --metrics-endpoint Configure runtime Prometheus metrics endpoint. Defaults to http://127.0.0.1:9090.

Spiced Flags

Flags that are passed to the spiced runtime directly using --.

• --http Configure runtime HTTP address [default: 127.0.0.1:8090]
• --flight Configure runtime Flight address [default: 127.0.0.1:50051]
• --metrics Enable and configure the Prometheus metrics endpoint (disabled by default)
• --tls-enabled Enable TLS
• --tls-certificate The TLS PEM-encoded certificate
• --tls-certificate-file Path to the TLS PEM-encoded certificate file
• --tls-key The TLS PEM-encoded key
• --tls-key-file Path to the TLS PEM-encoded key file
• --telemetry-enabled Enable or disable anonymous telemetry
• --pods-watcher-enabled Enable the pods watcher (disabled by default)
• --repl Start a SQL REPL against the runtime's Flight endpoint
• -v, --verbose Enable verbose logging (use -vv for more detail)
• --very-verbose Enable very verbose logging

Examples

--set-runtime

The --set-runtime flag overrides runtime configuration values. It can be specified multiple times to set multiple values. It is used like this: --set-runtime name=value. The Spicepod YAML equivalent of that is:

Examples:

--set-runtime task_history.captured_output=none:

--set-runtime results_cache.enabled=false:

--set-runtime runtime.tls.enabled=true --set-runtime runtime.tls.certificate_file=/path/to/cert.pem --set-runtime runtime.tls.key_file=/path/to/key.pem:

--endpoint

No arguments

--captured-outputs none

--http

--flight