mooMON

Installation

mooMON ships as a self-contained bundle for Windows, macOS and Linux — each one carries its own runtime, so there's no Python to install and no Oracle client. Unpack it, run it, connect.

Windows10 / 11 · 64-bit · .exe bundle macOSApple Silicon & Intel · .app Linuxx86_64 · glibc 2.43+ · tar.gz

Before you install

mooMON connects to Oracle in thin mode — it speaks the protocol directly, so there is nothing to configure beyond a network route to the database listener.

You needYou do not need
A 64-bit Windows, macOS or Linux machinePython — the bundle carries its own
A network route to the DB listener (host + port, usually 1521)An Oracle client, ORACLE_HOME or LD_LIBRARY_PATH
A desktop session to draw the window (it's a GUI app)Administrator / root rights — it unpacks in your home folder
Your database credentialsAny change on the database server
Which download? Use the self-contained bundle for your platform below. The source distribution (further down) is only for locked-down hosts where nothing may be installed but a compatible Python is already present.

Windows

Requires: Windows 10 or 11, 64-bit. Download: moomon-26.07.22.1-windows-x64.zip.

  1. Unzip the archive to a folder you own — for example C:\Users\you\Apps\moomon.
  2. Open the moomon folder and run moomon.exe.
  3. The connect dialog opens. Fill in your database details and connect.
“Windows protected your PC”. The first launch may show a SmartScreen prompt because the bundle isn't code-signed. Click More info → Run anyway. It appears once.

macOS

Requires: macOS 12 (Monterey) or newer, Apple Silicon or Intel. Download: moomon-26.07.22.1-macos.zip.

  1. Unzip the archive — you'll get mooMON.app. Drag it into Applications (optional).
  2. First launch: right-click (or Control-click) mooMON.app and choose Open, then confirm. This is needed once because the app isn't notarised.
  3. The connect dialog opens. Fill in your database details and connect.
If Gatekeeper still blocks it (“mooMON.app cannot be opened…”), clear the quarantine flag from Terminal and open it again:
xattr -dr com.apple.quarantine /Applications/mooMON.app

Linux

Requires: a 64-bit Linux with glibc 2.43 or newer (the version the current build targets) and a desktop session. Download: moomon-26.07.22.1-linux-x86_64.tar.gz.

  1. Check your glibc — it must be at least 2.43:
    ldd --version
  2. Unpack the archive somewhere you own:
    mkdir -p ~/apps && tar xzf moomon-26.07.22.1-linux-x86_64.tar.gz -C ~/apps
  3. Run it:
    cd ~/apps/moomon && ./moomon
Verify without a database or display (handy over SSH):
./moomon --selftest # prints SELFTEST: PASS
Older Linux? If it reports version `GLIBC_2.xx' not found, the target's glibc is older than 2.43 and the bundle must be rebuilt on a matching or older base. On a minimal/server install missing X libraries, see Troubleshooting.

From source (locked-down / production hosts)

Some production hosts allow nothing to be installed — no .exe, no internet — but already have a compatible Python. For those, mooMON ships as a source tree with every dependency vendored inside it, run with py -3. Download: moomon-26.07.22.1-cp314-win_amd64.tar.gz.

  1. Unpack the archive onto the host.
  2. From inside the folder, launch with the bundled-dependency interpreter:
    py -3 -m moomon.gui.app
Nothing to pip install. Every dependency is already vendored in the archive — the source distribution never needs internet access on the target.

First run

However you installed it, mooMON opens the connect dialog on first launch. Enter the host, port and service (or SID), your username and password, choose a role, and connect — or save a profile for next time. The full walkthrough is in the User Guide → Connecting.

Your settings — saved connections (passwords encrypted) and preferences live in ~/.moomon/, so they carry across upgrades automatically.

Upgrading

Unpack the new version alongside the old and switch to it — there's no installer and nothing registered with the system. Your saved connections and preferences in ~/.moomon/ are picked up by the new version. Confirm the version under Help → About.

Uninstalling

Delete the folder (or mooMON.app). Nothing else is written to the system. To remove your saved connections and preferences too, delete ~/.moomon/.

Troubleshooting

SymptomCause & fix
Windows: “protected your PC”Unsigned bundle — More info → Run anyway (once).
macOS: “cannot be opened…”Gatekeeper — right-click → Open, or clear quarantine (see macOS).
version `GLIBC_2.xx' not foundLinux glibc older than the build's — rebuild on an older base.
Could not load the Qt platform plugin “xcb”X11 desktop missing helper libs: sudo apt install libxcb-cursor0 libxkbcommon-x11-0
DPY-6005 / cannot connectNo route to the listener — check host, port and firewall: nc -vz <host> 1521
ORA-12514Listener reached but doesn't know that service — check service_name, or use a SID.
ORA-01017Wrong username or password. For an admin login, tick as SYSDBA.
Some tabs are greyed outExpected — the account lacks the catalog/V$ privileges those pages need. Ask your DBA for SELECT_CATALOG_ROLE.

Continue to the User Guide →