Rancher Desktop is the EA recommendation for running Docker on Jack Henry developer machines.

Do not install Docker Desktop. It requires a license for a company our size.

Installing Rancher Desktop

The following guide installs with Rancher Desktop on MacOS, ready for use with Testcontainers.

1. Uninstall Docker Desktop, if necessary.

   • If you installed with brew, uninstall with brew:

     brew uninstall --cask docker
     

   • If you installed the official way, uninstall the official way.

2. Install Rancher Desktop

   • If you brew,

     brew install --cask rancher
     

   • If you don’t brew, follow the official instructions.

3. Launch Rancher Desktop: the defaults on the initial splash screen are fine, but if you prefer to opt out of Kubernetes or manually manage your PATH, it will still work.

4. Switch to VZ emulation:

   1. Click Preferences (bottom left)
   2. On the popup, pick Virtual Machine (left)
   3. Tab to Emulation (top)
   4. Select the VZ option
   5. Enable Rosetta support to avoid problems with x86_64 container images
   6. Click Apply

   

5. Update your shell init. For most people, this is $HOME/.zshrc. Add them outside any commented lines about being managed by Rancher Desktop.

   export DOCKER_HOST=unix://$HOME/.rd/docker.sock
   export TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE=/var/run/docker.sock
   export TESTCONTAINERS_HOST_OVERRIDE=$(rdctl shell ip a show vznat | awk '/inet / {sub("/.*",""); print $2}')
   

If your team uses binci, you can also add the following to avoid errors regarding /tmp/binci.sh:

    export BINCI_TMP=/tmp/rancher-desktop
    mkdir -p $BINCI_TMP

6. Restart any terminals or editors from which you launch tests.
7. Login to Artifactory again with these instructions. Basically docker login docker.artifactory.banno-tools.com

Misc

• Rancher Desktop Dashboard listens on the same port as Logitech G Hub and Logi Options+. If you find that Rancher Desktop Dashboard doesn’t load, you must uninstall those apps.