Create a build

Note: The content on this page pertains to Game Server Hosting (Multiplay) available on the Unity Dashboard. If you’re using Game Server Hosting (Clanforge), see the Game Server Hosting (Clanforge) documentation.

The embedded setup guide walks you through creating your first build. However, you can always add more builds by following these instructions.

You can create a build:

Note: You can create up to 100 builds per organization.

Create a build with a direct upload

Warning: Builds created with the direct file upload process doesn't support symbolic links. If you want to use symbolic links, you must use a Container build.

Warning: There’s a 4 GB limit per file uploaded directly through the Unity Dashboard interface. You can avoid this limit by using the Game Server Hosting API.

  1. Go to the Unity Dashboard > Multiplayer > Multiplay.

  2. Select Builds > Create build.

  3. Fill in the build details:

    1. Give the new build a name.
    2. Select the operating system.
    3. Select the operating system version.
    4. Select Direct file upload for the upload method.
  4. Add the files required to run your game or application. The files should be in a loose, unzipped folder. At a minimum, the build files must contain an executable form of your game or application.

  5. Select Upload Files.

  6. Once the files finish uploading, select Next.

  7. Select Finish to automatically create the first release. Game Server Hosting can’t run a build on a server unless the build has at least one release.

You now have a new build. Before you can use the build, you need to create (and link) a build configuration and a fleet. See Create a build configuration.

Create a build with a container image

See Container builds to learn more.

  1. Go to the Unity Dashboard > Multiplayer > Game Server Hosting.

  2. Select Builds > Create build.

  3. Fill in the build details:

    1. Give the new build a name.
    2. Select the operating system.
    3. Select the operating system version.
    4. Select Container image for the upload method.
  4. Select Next to continue to the Service account step.

  5. To add your container image to the Game Server Hosting registry, you’ll need a service account. Follow the below instructions:

    1. Go to the Service accounts page and create a new service account. If you already have a service account, continue to the next step
    2. In the Keys section of your service account, create a new key and store both the Key ID and the Secret key somewhere safe.
    3. Within the Project roles section of your service account, add the Game Server Hosting Registry Editor role.
  6. Select Next to continue to the Add to registry step.

  7. Follow the below instructions to add your container image to the Game Server Hosting registry.

    1. Log into the Game Server Hosting container registry with your service account. Use your Key ID for the username and your Secret Key for the password: docker login registry.multiplay.com -u <KeyID> -p <SecretKey>
    2. Tag your container image with the following: docker tag <ImageName>:<ImageTag> registry.multiplay.com/<Uuid>/12788:v1
    3. Push your container image to the Game Server Hosting registry: docker push registry.multiplay.com/<Uuid>:v1
  8. Select Next to continue to the Select image step.

  9. Choose the method by which you want to select your image.

    1. Select your image from the Container image dropdown list.

You now have a new build. Before you can use the build, you need to create (and link) a build configuration and a fleet. See Create a build configuration.