Prerequisites for setting up a containerized developer toolkit on Mac M1

The developer toolkit installation is supported on Mac M1. You can install Docker by using Colima or Rancher Desktop.

Important:

If you are setting up the developer toolkit before the 10.0.2409.2 release on Mac Mx, and if you encounter issues while pulling the docker.io/ibmoms/mq-core_arm64:9.3.3.0 image from Docker Hub, perform the following steps to resolve the issue:
1. Go to compose/docker directory and open the docker-compose.properties file
2. Search for MQ_IMAGE_ARM64=ibmoms/mq-core_arm64 and change it to MQ_IMAGE_ARM64=icr.io/cpopen/ibm-oms/mq-core
3. Search for MQ_TAG_ARM64=9.3.3.0 and change it to MQ_TAG_ARM64=9.3.3.0_arm64
While setting up the developer toolkit, if you encounter any issue, complete the following steps:
1. Browse to the compose/docker/docker-compose.yml file.
2. In service: omruntime, add user: root before the enviornment: tag as illustrated in the following sample file.
```
services:
 omruntime:
  image: ${OM_IMAGE}:${OM_TAG}
  entrypoint: ''
  command: ["sleep","infinity"]
  user: root
  environment:
   - DUMMY_PATH_PROP=1
```

To install Docker by using the Rancher Desktop, see Rancher Desktop documentation. By default, Rancher Desktop uses 9080 and 9443 ports. Before running the DTK setup, ensure that you update the AP_HTTP_PORT and AP_HTTPS_PORT properties to use other available ports. For more information, see Overriding the default docker compose properties.

To install Docker by using Colima, complete the following steps:

Procedure

Install Docker by using Colima.

Run the following command:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
touch ~/.zshrc

Add the following command at the end of .zshrc.
```
export PATH=/opt/homebrew/bin:$PATH
```

Open the Terminal and run the following commands:

```
source ~/.zshrc
```

brew install colima docker docker-compose

Start Colima by running the following command:
```
Colima start --cpu 8 --memory 8 --disk 80
```

Install Docker Compose version 2.x that is tested on 2.23.0 and 2.24 versions. For more information about installing Docker Compose, see Overview of Docker Compose and Install Docker Compose.
Stop or disable any native DB2®, WebSphere Application Server, Liberty, or IBM MQ application services that are running locally as these services might use system resources and the port numbers might conflict with the Docker Compose environment.
On the host machine, browse to the /etc/hosts file and add mqserver as a localhost.