Dodeca macOS Installation Guide

Installing the Dodeca macOS App

The Dodeca.<version>.dmg package delivers the Dodeca Smart Client for macOS. Rather than requiring a native Windows installation, the macOS app runs the standard Dodeca Smart Client through CodeWeavers CrossOver technology (based on WINE). The macOS app is a client only; it connects to a Dodeca Application Server exactly like the Windows client, so you will still need the server address, port, tenant, and application information for your environment.

The macOS app bundles everything needed to run the client. The first time it launches, it performs a one-time setup of the required Windows/.NET runtime components inside the app’s private environment. This one-time step is expected and occurs only on the first run.

Installing the Application

  1. Download the Dodeca.<version>.dmg file for your Dodeca version.

  2. Double-click the downloaded .dmg file to open it. A window opens showing the Dodeca application and a shortcut to the macOS Applications folder.

  3. Drag the Dodeca application onto the Applications folder shortcut to copy it into /Applications.

    The application is named with its version number, for example Dodeca <version>.app.

  4. After the copy completes, eject the disk image by clicking the eject icon next to it in Finder (or by dragging it to the Trash).

Always run Dodeca from the Applications folder, not from the mounted disk image. Running directly from the .dmg can cause the first-run setup to fail or behave unexpectedly.

Launching Dodeca for the First Time

  1. Open the Applications folder in Finder and double-click the Dodeca application.

  2. Because the app was downloaded from the internet, macOS may display a Gatekeeper security prompt before allowing it to run. If the app does not open:

    1. Open System Settings > Privacy & Security.

    2. Scroll to the Security section, locate the message about Dodeca, and click Open Anyway.

    3. Confirm that you want to open the application.

  3. On the first launch, Dodeca completes a one-time installation of its bundled Windows/.NET runtime components. Follow any prompts that appear and allow the process to finish. Depending on your machine, this can take a few minutes.

  4. When the one-time setup is complete, Dodeca may prompt you to relaunch, or you can start it again from the Applications folder. Subsequent launches start directly without repeating the setup.

  5. Verify that the Dodeca Smart Client starts and displays its splash screen followed by the application window.

Entering Connection Information

The first time the client starts, enter the connection details for your Dodeca environment when prompted:

  • Application Server – the host name or address of your Dodeca Application Server.

  • Port – the port on which the Dodeca server is listening.

  • Tenant – the tenant key for your application (for example, SAMPLE).

  • Application – the application ID you want to open (for example, ADMIN).

Your Dodeca administrator can provide the correct values for your environment. Once entered, the client connects to the server and opens the requested application.

Troubleshooting

The following are common issues encountered when installing or first launching the Dodeca macOS app.

Application was launched from the disk image

If Dodeca does not start correctly, confirm that you copied it to the Applications folder and are launching it from there, not from the mounted .dmg. Eject the disk image, then launch the copy in Applications.

macOS blocks the app from opening

If macOS reports that the app cannot be opened because it is from an unidentified developer or was downloaded from the internet, use System Settings > Privacy & Security > Open Anyway as described above, then try again.

Application closes or does nothing after the first-run setup

The bundled runtime installation completes only on the first launch. If the app appears to close after this step, launch it again from the Applications folder — the second launch starts the client normally.

Resetting after a failed or corrupted install

If the client will not start, or you want to start over from a clean state, remove the Dodeca files as described in Resetting or Completely Removing the macOS App, then relaunch the app to repeat the first-run setup.

Resetting or Completely Removing the macOS App

Dodeca stores runtime and preference files in your macOS user Library folder in addition to the application itself. Removing these files returns your system to the state it was in before Dodeca was installed and is the recommended way to fully reset the app when troubleshooting.

To completely remove Dodeca, first quit the application, then delete the following items:

Item Location

The Dodeca application

/Applications/Dodeca <version>.app

Application support files

~/Library/Application Support/Dodeca

Saved preferences

~/Library/Preferences/com.appliedolap.dodeca.plist

Saved application state

~/Library/Saved Application State/com.appliedolap.dodeca.savedState
The com.appliedolap.dodeca.plist and com.appliedolap.dodeca.savedState items are not always present. If they do not exist, no action is needed for those items.

You can remove these items using Finder or the Terminal.

Using Finder:

  1. Quit Dodeca if it is running.

  2. In Finder, choose Go > Go to Folder…​ (or press Shift+Command+G).

  3. Enter ~/Library and press Return.

  4. Delete the Application Support/Dodeca folder and, if present, the Preferences/com.appliedolap.dodeca.plist and Saved Application State/com.appliedolap.dodeca.savedState items.

  5. Drag the Dodeca application from the Applications folder to the Trash.

  6. Empty the Trash.

Using the Terminal:

Quit Dodeca, then run the following commands (replace <version> with your installed version):

rm -rf "/Applications/Dodeca <version>.app"
rm -rf ~/Library/Application\ Support/Dodeca
rm -f  ~/Library/Preferences/com.appliedolap.dodeca.plist
rm -rf ~/Library/Saved\ Application\ State/com.appliedolap.dodeca.savedState
After removing these files, you can perform a fresh installation by following the steps in Installing the Application. The next launch will repeat the one-time first-run setup.