Get SpatialOS


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

Deploying locally from the command line

This page covers deploying locally using the spatial command-line tool. With our game engine integrations, you can deploy directly from the game engine editor.

This page is about local deployments. For information about cloud deployments, see Deploying to the cloud.

Deploy from the command line

To run a local deployment from the command line:

  1. Open a terminal and navigate (cd) to the root directory of your project.
  2. If you have a default launch configuration file (default_launch.json), run the command:

    spatial local launch

    Alternatively, run

    spatial local launch <launch configuration>


    • launch configuration specifies the launch configuration file you want to use. For example, development.json. For information about this file, see the launch configuration page.

    Run spatial local launch --help for more information.

When SpatialOS starts successfully, you should see SpatialOS ready in the console. At this point, you can access the Inspector at http://localhost:21000/inspector and connect workers.

Connect workers to the deployment

You can connect any type of worker to a local deployment from the command line, but usually you’ll just want to connect clients.

To do this, use:

spatial local worker launch <worker type> <launch_config>


  • worker type: the type of the worker. For example, UnityClient.
  • launch_config: the launch configuration file.

Run spatial local worker launch --help for more information.

For example, to start a UnityClient using the default launch configuration, run

spatial local worker launch UnityClient default

When successful, you will see the new Unity client worker at http://localhost:21000/inspector.

Stop a local deployment

When spatial local launch is running, use Ctrl + C to stop it.

There’s a known issue where Ctrl + C sometimes doesn’t properly stop all processes. See this forum post for fixes and workarounds.

Search results

Was this page helpful?

Thanks for letting us know!

Thanks for your feedback

Need more help? Ask on the forums