These are the docs for 12.2, 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 →



The C# worker SDK assumes that you have the 64-bit version of Mono installed on your machine, and that it is on your system path. This should include both mono the runtime, and xbuild. The SpatialOS deployment clusters have version or newer installed and on PATH, including the 64-bit version. This is the environment managed workers will run in.

Mono on Windows with MSBuild

Note that since version 5.0.0 Mono has a bug on Windows. This causes it not to include the C# compiler.

As a workaround for this bug, if you have compiler errors when building a worker, add MSBuild which comes with Visual Studio to your PATH environment variable before mono. This will cause Mono’s msbuild to use the csc compiler of MSBuild instead.

Mono on macOS

Note that the macOS version of Mono is distributed as a universal binary, which requires --arch=64 to be passed to the command line when launching your worker.


On Windows, client workers depend on the Visual C++ Redistributable for Visual Studio 2015.


Follow the standard SpatialOS setup guide (Windows / macOS / Linux).

You can install Mono using the installation guides: (Windows / macOS / Linux).

On Windows, Mono is required only for the generated build scripts.

On macOS, the C# worker SDK works with the latest Mono.

Search results

Was this page helpful?

Thanks for letting us know!

Thanks for your feedback

Need more help? Ask on the forums