Skip to main content

Restate Server

The Restate Server has a wide range of configuration options to tune it according to your needs.

Configuration file

The Restate Server accepts a TOML configuration file that can be specified either providing the command-line option --config-file=<PATH> or setting the environment variable RESTATE_CONFIG=<PATH>. If not set, the default configuration will be applied.


Restate server accepts a sub-set of the configuration through command-line arguments, you can see all available options by adding --help to restate-server.

The order of applying configuration layers follows the following order:

  1. Built-in defaults
  2. Configuration file (--config-file or via RESTATE_CONFIG)
  3. Environment variables
  4. Command line arguments (--cluster-name=<VALUE>)

Every layer overrides the previous. For instance, command-line arguments will override a configuration key supplied through environment variable (if set).

Environment variables

You can override any configuration entry with an environment variable, this overrides values loaded from the configuration file. To do that, the following rule applies:

  • Prefix the configuration entry key with RESTATE_
  • Separate every nested struct with __ (double underscore) and all hyphens - with a _ (single underscore).

For example, to override the admin.bind-address, the corresponding environment variable is RESTATE_ADMIN__BIND_ADDRESS.

Configuration introspection

If you want to generate a configuration file that includes values loaded from your environment variables or overrides applied to restate-server command-line, you can add --dump-config to dump the default TOML config with overrides applied:

restate-server --cluster-name=mycluster --dump-config

Example output:

roles = [
cluster-name = "mycluster"

At any time, you ask restate daemon to print the loaded configuration to the log by sending a SIGUSR1 to the server process. This prints a dump of the live configuration to standard error.

For instance on Mac/Linux, you can find the PID of restate-server by running:

pgrep restate-server

Then send the signal to the process ID returned from pgrep's output:

kill -USR1 994921

Observe the output of the server for a dump of the configuration file contents.

Default configuration


Note that configuration defaults might change across server releases, if you want to make sure you use stable values, use an explicit configuration file an pass the path via --config-path=<PATH> as described above.

roles = [
cluster-name = "localcluster"
allow-bootstrap = true
metadata-store-address = ""
bind-address = ""
advertised-address = ""
bootstrap-num-partitions = 24
shutdown-timeout = "1m"
tracing-filter = "info"
log-filter = "warn,restate=info"
log-format = "pretty"
log-disable-ansi-codes = false
connect-timeout = "10s"
disable-prometheus = false
rocksdb-total-memory-size = "6.0 GB"
rocksdb-total-memtables-ratio = 0.5
rocksdb-high-priority-bg-threads = 2
rocksdb-write-stall-threshold = "3s"
rocksdb-enable-stall-on-memory-limit = false
rocksdb-perf-level = "enable-count"

interval = "40s"
timeout = "20s"

internal-queue-length = 10000

rocksdb-disable-wal = true
rocksdb-memory-ratio = 0.49000000953674316
persist-lsn-interval = "1h"
persist-lsn-threshold = 1000

inactivity-timeout = "1m"
abort-timeout = "1m"
message-size-warning = "10.0 MB"
concurrent-invocations-limit = 10000

type = "exponential"
initial-interval = "50ms"
factor = 2.0
max-interval = "10s"

bind-address = ""
heartbeat-interval = "1s 500ms"
log-trim-interval = "1h"
log-trim-threshold = 1000

memory-size = "4.0 GB"
pgsql-bind-address = ""

bind-address = ""
kafka-clusters = []

default-provider = "local"

rocksdb-disable-wal = false
rocksdb-memory-ratio = 0.5
rocksdb-disable-wal-fsync = false
writer-batch-commit-count = 5000
writer-batch-commit-duration = "0s"

bind-address = ""
request-queue-length = 32
rocksdb-memory-ratio = 0.009999999776482582

rocksdb-disable-wal = false

Configuration reference

Loading ....