Downloading Game Images
The Image Manager implements the Docker V2 HTTP API spec meaning you can
docker pull command with authentication to pull an Image from Image Manager to your machine. You can authenticate
by using either an IMS User account or IMS Service Account.
If you have any problems with following the steps outlined here, reach out for help in the #ims-image-management channel.
In order to download an Image in the Image Manager you need the following tools:
First you need to authenticate docker with the Image Manager, to do this we provide the
ims image get-login-passwordcommand which will generate an access token that is valid for 20 minutes. You can then pipe the output into
docker login --username gir --password-stdin gir.improbable.io(the username is always GIR).
For example (using the default IMS web login flow):
ims image get-login-password | docker login --username gir --password-stdin gir.improbable.io
If you wish to use this from an environment where you can't open a web browser, you can use a service account for authentication via the
--ciflag, for example:
ims image get-login-password --ci | docker login --username gir --password-stdin gir.improbable.io
For more information on the different authentication flows and how to set them up please see How Do I Authenticate?.
Next, identify the Image you wish to pull using the
image listCLI command and record the Image URL.
Finally, you can pull the image by providing
docker pull YOUR_IMAGE_URL