Metaplay Docs

Appearance

metaplay build image [IMAGE] [flags] [-- EXTRA_ARGS]

Build a Docker image of the server components that can be deployed in the cloud

metaplay build image [IMAGE] [flags] [-- EXTRA_ARGS] ​

Build a Docker image of your project to be deployed in the cloud. The built image contains both the game server (C# project), the LiveOps Dashboard, and the BotClient.

Expected arguments:

  • IMAGE (optional) -- Docker image name (optional) and tag, eg, 'mygame:20260601-153000-1a27c25' or '20260601-153000-1a27c25'.
  • EXTRA_ARGS (optional) -- Passed as-is to docker build.

Related commands:

  • 'metaplay deploy server ...' to push and deploy the game server image into a cloud environment.
  • 'metaplay image push ...' to push the built image into a target environment's registry.

Examples ​

sh
# Build Docker image, produces image named '<projectID>:YYYYMMDD-HHMMSS-COMMIT_ID'.
metaplay build image
# Specify only the tag, produces image named '<projectID>:20260601-153000-1a27c25'.
metaplay build image 20260601-153000-1a27c25
# Build a project from another directory.
metaplay -p ../MyProject build image
# sort in the order the images were built.
export IMAGE_TAG="$(date -u +%Y%m%d-%H%M%S)-$COMMIT_ID"
  metaplay build image mygame:$IMAGE_TAG --commit-id=$COMMIT_ID --build-number=$BUILD_NUMBER
# Build an image to be run on an arm64 machine.
metaplay build image mygame:20260601-153000-1a27c25 --architecture=arm64
# Build a multi-arch image for both amd64 and arm64 (only supported with 'buildx').
metaplay build image mygame:20260601-153000-1a27c25 --architecture=amd64,arm64
# Pass extra arguments to the docker build.
metaplay build image mygame:20260601-153000-1a27c25 -- --build-arg FOO=BAR

Flags ​

  • --architecture <stringSlice>: Architectures of build targets (comma-separated), eg, 'amd64' or 'amd64,arm64' (default: [amd64])
  • --build-number <string>: Number identifying this build, eg, '715'
  • --commit-id <string>: Git commit SHA hash or similar, eg, '7d1ebc858b'
  • --engine <string>: Docker build engine to use ('buildx' or 'buildkit' [deprecated]) (default: buildx)

Inherited Flags ​

  • --color <string>: Should the output be colored (yes/no/auto)? [env: METAPLAYCLI_COLOR] (default: auto)
  • --project <string>: Path to the to project directory (where metaplay-project.yaml is located)
  • --skip-version-check: Skip the check for a new CLI version being available
  • --verbose: Enable verbose logging, useful for troubleshooting [env: METAPLAYCLI_VERBOSE]