Skip to content


The ApplicationBuild element points to your build archive which must be uploaded to the CDN. You must provide information on how to run the build by assigning the name of the exectuable, provide startup parameters, which OS it must run on, etc.

More information on Build Provisioning

Element structure

Property Value type Required Description
id string Read-only Unique identifier of this element
name string Yes User defined name of this element
applicationId string Read-only Unique identifier of the Application element this belongs to
osId int Yes ID of the operating system (see Supported operating systems)
stopMethod int No The stop method that will be used on restart or destroy of an application instance. The default is taken from the value of Application.stopMethod - any value submitted here overrides that Application default
stopTimeout int No The timeout that will be used on restart or destroy of an application instance. The default is taken from the value of Application.stopTimeout - any value submitted here overrides that Application default
executable string Yes Name of the executable file that our system must run to start the application
startupParameters string Yes Startup parameters passed to the executable
runAsNonePrivileged int No 0: run as root user (default)
1: run as non-privileged user.
This currently only works for builds deployed onto a Linux operating system. Windows builds will always run as administrator.
instanceDoesReadyCallback int No Set to 1 if a deployed application instance will inform the platform it's done with initializing and is ready to accept players. Defaults to 0 if not set, which means an instance's status will go directly to ONLINE (4) after starting
type int Read-only The application build type. A list of types can be found in: GET /application/type
applicationBuildFile ApplicationBuildFile Yes An object describing the location of the original build archive.
buildProvisioningStorageType int Yes Type of storage being used. You can find all types in GET /v3/buildes
hostCapacityTemplateId int No ID of the HostCapacityTemplate to assign to this ApplicationBuild
label [Label] No Collection of client-defined labels
createdAt int Read-only A unix timestamp of when this element was created
Table 1: ApplicationBuild element structure

Executable & startupParameters

You must provide us with the file name of the executable inside your build archive, in order for us to be able to run your application. If the executable is inside of a subfolder, you must provide this path as well. Note that the path here is relative.

When starting your application, we will append the contents of the startupParameters property to the executable. You can enter any command line arguments you need for your application to run properly. You can use variables inside the startupParameters to use dynamic values such as a game server's network port, IP address, host ID, game server ID, etc. All available variables are explained in the Platform Variables chapter. It includes an example with fictional startupParameters.

Running with lowered privileges

By default we will run your applications with the root or administrator user. If you prefer, for security reasons, to run your utilities and / or game servers with lowered privileges, you can set the property runAsNonePrivileged to 1.


This feature is only available on Linux as this time. Builds meant to run on Windows will always be exectued with the Administrator user.

Supported operating systems

The platform currently supports the following operating systems that you can use to run your applications on:

  • Ubuntu 16.04
  • Ubuntu 18.04
  • Ubuntu 20.04
  • Centos 8
  • Debian 10
  • Windows Server 2016
  • Windows Server 2019

You can also programmatically fetch the list of supported operating systems via GET /v3/operatingsystem and applying a filter on the 'odpSupported' property.

If you need to use an OS that is currently not supported, you can request support for this by filing a ticket with us.

ApplicationBuild labels

A user can define custom labels (key / value pairs) for an ApplicationBuild, to allow for easy identification and filtering of ApplicationBuild elements.


Just like with the Application element, an ApplicationBuild can be assigned properties, by assigning ApplicationBuildProperty elements to an ApplicationBuild.

Note that properties assigned to an Application will already be inherited by an ApplicationBuild, so there is no need to re-define those for each ApplicationBuild. Unless you want to override a certain property for an ApplicationBuild.

ApplicationBuild creation process flow

An ApplicationBuild is created by calling the endpoint POST /applicationBuild and is the final stage of the ApplicationBuild creation process:

Figure 1: ApplicationBuild creation process


See also: Application element relations


You can have any number of ApplicationBuilds on your account. There is no limit.