Setting up containerized developer toolkit on macOS

The developer toolkit installation is supported on macOS 10.13 High Sierra or later. Ensure that the following prerequisites are completed before you set up the developer toolkit.

Important: The developer toolkit is certified on macOS with the newer ARM-based Apple Silicon chipset processor such as Apple M1.

Procedure

  1. Install the latest JDK 1.8 Update 151 or more recent updates of JDK 1.8 for macOS.
  2. Provide enough memory in the Advanced settings under Docker preferences.
    For a seamless developer toolkit experience, a minimum of 6 GB of memory is suggested.
  3. (Optional) Install the coreutils utility by running brew install coreutils.
  4. After you install JDK, navigate to your /Users/<username>/Library/Java directory and create a directory that is named Extensions, if it does not exist.
    After your setup is finished and you run commands from your extracted runtime/bin directory with errors, check that the Extensions directory is found. Ensure that the Extensions directory is in the correct path that is specified in the error log.
  5. Install Docker. After installation, ensure that you start Docker and verify that Docker is installed correctly. For more information about installing Docker, see Install Docker Desktop on Mac.
    Note: The terms of service for Docker Desktop changed on 31 August 2021. For more information about Docker, see Updating Docker subscriptions.

    For more information about Docker, see Orientation and setup.

    You must set up the developer toolkit environment on a Linux®-based environment as a non-root user. To add the user to the docker group, see Manage Docker as a non-root user.
    Note: Do not use a root user or set up the developer toolkit environment in the /root directory.
  6. Install Docker Compose version 2.x (tested on 2.23.0, 2.24 versions). For more information, see Install Docker Compose. For more information about Docker Compose, see Overview of Docker Compose.
  7. It is recommended that you either stop or disable any native Db2®, WebSphere® Application Server, Liberty, or IBM MQ application services that are running locally because they can unnecessarily use system resources, and the port numbers may conflict with the Docker Compose environment.
  8. On the host machine, add mqserver as a localhost in your /etc/hosts file.