Category: Projects Related to Palm OS PDAs

How to run POSE in a Docker-Container on Mac OS X

Published on: 2022-05-07

Since POSE is a very old 32-bit application, which runs perfectly fine on Linux and Windows - even on current versions of these operating systems - it does not run on Mac OS X without heavy changes to the source code to make it 64-bit ready.

A reader of this website, Haemish Graham, tackled this problem and found a way to run POSE in a Docker container on Mac OS X. This was successfully tested on a new M1 (Apple Silicon). But, of course, it should also run on Intel Macs. Haemish used the following articles as a basis for this tutorial:

The current version of his project has some nice features:

  1. Mounts a share of ~/Public on the host to /public on the container (put your ROMs, apps, SDKs, docs here)
  2. Contains a full build of the prc-tool-remix built for i386 (credit to Chuan Ji - jichu4n)
  3. Adds the missing libraries required to run pilrcui (mostly from

Haemish built an image with docs, ROMs, apps, and SDKs so that it was a self-contained project, but those choices are personal and can be individually customized:

Of course, besides the tarball, a Docker environment is also required.

The next steps are also included in the of the tarball:

The configuration looks like this:

The container and XQuartz can be started with these commands:

Now everything is ready for the connection:

At this point, POSE should have started and you should be able to select a ROM file, which was placed in the "palmos-docker" folder on your Mac (the extracted tarball) and which is available in "/palmos" in the container. It is also possible to add applications in this folder, which can then be installed in POSE.

So, big thanks to Haemish Graham for letting me publish this work on this page!