System requirements
Software
Windows requirements
Up-to-date versions of Windows 7 and 10 are supported.
Required for | |
---|---|
All SpatialOS development | the SpatialOS CLI PowerShell 3.0 and later / Windows Command Prompt / Git BASH (For local deployments, you must use PowerShell or Command Prompt.) Visual C++ Redistributable for Visual Studio 2015 |
Worker SDK: C# | Mono — required for the generated build scripts only. |
Worker SDK: C++ | A C++11-compliant compiler: Visual Studio 2015 or later |
Worker SDK: Java | Gradle version 2.10 |
Worker SDK: C | Microsoft Visual Studio 2015 Update 3 and above. |
You can find installation instructions for the basic requirements in the tools installation guide for Windows.
macOS requirements
We support up-to-date versions of macOS Sierra, El Capitan and High Sierra.
Required for | |
---|---|
All SpatialOS development | the SpatialOS CLI Any Bash terminal |
Worker SDK: C# | Mono |
Worker SDK: C++ | A C++11-compliant compiler: Tested with Xcode 8. You’ll need to use the -std=c++11 flag when compiling your worker |
Worker SDK: Java | Gradle version 2.10 |
Worker SDK: C | OS X Yosemite (10.10) and above |
You can find installation instructions for the basic requirements in the tools installation guide for macOS.
Linux requirements
All major distributions (e.g,. Ubuntu, Fedora, CentOS) on machines with an AMD64 processor are supported for use with the Worker SDK in C++, C# and Java. The Launcher is not supported, and the SpatialOS CLI is in beta.
Required for | |
---|---|
All SpatialOS development | the SpatialOS CLI Any Bash terminal |
Worker SDK: C# | Mono |
Worker SDK: C++ | A C++11-compliant compiler: Tested with GCC 5.4.0. You’ll need to use the -std=c++11 flag when compiling your worker |
Worker SDK: Java | Gradle version 2.10 or later |
Worker SDK: C | gcc 5.4.0 with GLIBCXX_3.4.21 and above. |
You can find installation instructions for the basic requirements in the tools installation guide for Linux.
Browsers
To access the Console and Inspector, you’ll need one of the following:
spatial worker build
andspatial worker codegen
include an authentication step that opens a browser tab. This authentication won’t work if your default browser is Microsoft Edge or Internet Explorer. It’s most reliable when your default browser is Chrome or Firefox.
Hardware
Hardware requirements apply to all currently supported operating systems.
Recommended | |
---|---|
Processor | i7 |
Memory | 16GB RAM |
Network | High-speed broadband internet connection |
Storage | 12GB available space |
Network settings
Your firewall settings must allow outbound TCP connections on ports 443 and 444 in order to authenticate on the SpatialOS platform, download SDKs and contact other cloud services.
You must not filter inbound and outbound connections to
localhost
(IP:127.0.0.1
) or submit such connections to proxy rules.You must also not block the opening of ports bound to
localhost
. This is required to run local deployments via thespatial local
command.You must allow TCP and UDP outbound connections on the 8000-8999 port range for connecting clients to a cloud deployment. This is also a requirement for any third-party users who want to connect to your deployments (when you share a game).
You must keep port
22000
free for local deployments.
Supported deployment environments
When you build workers to be deployed, the only supported deployment platform for server-workers is Linux.
Windows, macOS and Linux are also supported for running client-workers and unmanaged workers.