These are the docs for 13.8, an old version of SpatialOS. The docs for this version are frozen: we do not correct, update or republish them. 14.5 is the newest →

spatial local worker replace

Replaces an existing worker with a different one.


Issues a request to replace a worker instance in the load balancing system of the locally-running deployment.

If you supply the ID of a 'replacing' worker instance that you want to take over some work, and the ID of an 'existing' worker instance whose work the replacing worker instance should take over, the load balancer will internally remap existing authority from the existing worker instance to the replacing worker instance.

If the ‘replacing’ worker is already connected, it will be assigned the ‘existing’ worker’s authority immediately. If the ‘replacing’ worker is not connected, it will receive the authority of the ‘existing’ worker upon connection to the deployment, but the ‘existing’ worker will lose authority immediately.

spatial local worker replace [flags]


      --existing_worker_id string        The worker ID of a worker instance already connected to the deployment, whose load-balancing assignments should be taken over by the replacing worker instance
      --local_service_grpc_port uint16   The port on which the local version of Improbable's public gRPC services are running. (default 22000)
      --replacing_worker_id string       The worker ID of the worker instance that should take over from the existing worker. The replacing worker instance can be connected to the deployment already, but it doesn't have to be.

Options inherited from parent commands

      --json_output            Print output in JSON format. Useful when you need to parse the Spatial CLI output.
      --log_directory string   Sets the directory log files will be created in. If not specified, this is set to <project_root>/logs when inside a project directory and logging is disabled when outside a project directory.
      --log_level string       Sets the log level. Available log levels: debug, info, warning, error, fatal, or panic.
      --main_config string     The path to your project's main configuration file (usually called spatialos.json)
      --no_animation           Disable dynamic output elements such as the spinner, progress bars, etc.

Search results

Was this page helpful?

Thanks for letting us know!

Thanks for your feedback

Need more help? Ask on the forums