Deploy locally

This page covers deploying locally using the SpatialOS CLI. 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
  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>


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.

You can use spatial local launch to launch a local deployment offline, so you can iterate on local projects without an internet connection. For more information, see Using the SpatialOS CLI offline for local projects.

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>


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

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

spatial local worker launch MyCSharpClient default

When successful, you will see the new client at

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.

Updated about a year ago

Deploy locally

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.