Downloading the IBM PEM Docker image

This topic describes the steps to pull the IBM PEM docker image.

Prerequisite

Install Bluemix CLI. You can find instructions on installing Bluemix CLI in IBM Bluemix Docs.
Install the Bluemix CLI plug-in for IBM Cloud Container Registry (plug-in name is container-registry) by running the following command:
```
ibmcloud plugin install container-registry -r Bluemix
```

Downloading the IBM PEM docker image

Note: To know the contents of IBM PEM Docker image, see IBM PEM Docker image contents.

To download the IBM PEM Docker image, complete the following steps:

Run the command, ibmcloud login.
If prompted for an API, provide https://api.ng.bluemix.net
Enter your IBM ID and password.
After successful authentication, if your IBM ID is onboarded to multiple accounts on IBM Bluemix, you are prompted to select an account. Select the IBM PEM account.

Alternatively, you can use the API key to login. Run the command ibmcloud login --apikey <API key>.
Note: To create an API key, see IBM Bluemix documentation.

Note: To verify IBM signed images are extracted in your environment, see
Note:
- After you select the account, the following message might get displayed:
  A new version of Bluemix CLI is available. Do you want to update? (yes/no) [yes]>
  
  Enter yes to update Bluemix CLI.
- After the Bluemix CLI is downloaded, the following message might get displayed:
  Do you want to launch CLI installer? (yes/no) [yes]
  
  Enter yes to launch the installer.
Note: If the following error message is displayed, run the command, ibmcloud target --cf.
```
No org or space targeted, use 'ibmcloud target --cf or ibmcloud target -o ORG -s SPACE'
```
Login to the IBM Container registry by using the following command:
```
ibmcloud cr login
```
To list IBM PEM images that are available in the Bluemix repository, run the following command:
```
ibmcloud cr images
```
Download the image as communicated in the release email that is sent from IBM about the availability of the new IBM PEM docker image ready for download.
To download the image, run the command, docker pull <image name>:<version>.

Here <image name>:<version> is the complete name of the image that is communicated to you. An example of the image name is, registry.ng.bluemix.net/gold/pem:3.5.16.

Alternatively, you can also pull the most recent version of the IBM PEM docker image that is available in the Bluemix repository.

All IBM PEM docker images have a shelf life of 120 days, starting from the day when the IBM PEM docker image is released, after which the image expires. Appropriate notification is displayed in the PEM Portal, PEM Partner Repository, and PEM Partner Provisioner UI specifying the number of days remaining for the docker image to expire. Ensure to upgrade to the latest available version of the IBM PEM docker image before the image expiry date.

Important: Ensure that you are using the latest version of the IBM PEM docker image.

For starting any IBM PEM containers, you also need to download the mount files. For more information, see Configuring the files in Mount directory.