Skip to content

Installation

Ontologizer is available as prepackaged installers for macOS, Windows, and Linux. Download the latest version from the Releases page.

Installing on macOS

File to download: Ontologizer_<version>_aarch64.dmg

This is the macOS installer for Apple Silicon (M1/M2/M3/M4 Macs)

  1. Download the .dmg file from the Releases page
  2. Open the DMG and drag the app into your Applications folder
  3. When you try to open it, macOS will show the message:
    "'Ontologizer' is an app downloaded from the Internet. Are you sure you want to open it?"

If you confirm, the app will be installed into your `Àpplications``folder and started. From now one you can open Ontologizer like any other application (e.g., using the Spotlight searchbar).

Installing on Windows

File to download: Ontologizer_<version>_x64_en-US.msi
Windows installer (MSI format)

  1. Download the .msi installer from the Releases page
  2. Double-click to start the installer
  3. If Windows shows a blue SmartScreen dialog saying:
    "Windows protected your PC"
  4. Click "More info" → "Run anyway"

Note: Windows shows this for unsigned apps from new developers. Once you install and run it, the warning will not reappear.

Installing on Linux

File to download: Ontologizer_<version>_amd64.deb
Debian/Ubuntu package

  1. Download the .deb package from the Releases page
  2. Install using: 
    sudo apt install ./Ontologizer_<version>_amd64.deb

Or using dpkg: 

sudo dpkg -i Ontologizer_<version>_amd64.deb

Other Linux Distributions

File to download: Ontologizer_<version>_amd64.AppImage
Universal Linux application (no installation needed)

  1. Download the .AppImage file from the Releases page

  2. Make it executable: 

    chmod +x Ontologizer_<version>_amd64.AppImage

  3. Run it: 

    ./Ontologizer_<version>_amd64.AppImage

Note for Arch-based distributions (e.g. EndeavourOS, Manjaro, etc.): The AppImage may not build/run correctly due to linuxdeploy compatibility issues. Use the .deb package instead (installable via debtap), or build from source and run the binary directly at ./src-tauri/target/release/ontologizer-gui.

Troubleshooting on Linux

Crash on launch: Failed to create GBM buffer (hybrid GPU / Wayland)

It seems that the Tauri/wry rendering stack on Linux goes through WebKit2GTK, which by default attempts GPU-accelerated compositing via EGL and GBM. On hybrid GPU systems with NVIDIA drivers under Wayland, GBM buffer allocation can fail because the NVIDIA proprietary driver's GBM support is incomplete or incompatible with how WebKit2GTK requests buffers. The workaround is to disable WebKit2GTK GPU compositing:

WEBKIT_DISABLE_COMPOSITING_MODE=1 ./src-tauri/target/release/ontologizer-gui

Crash during cohort verification (no error message)

A crash with no error message has been observed when verifying cohort data prior to Ontologizer export, after tabular data has been pasted successfully. The root cause is under investigation. If you encounter this, please report your steps in the issue tracker.

Building from Source

This will work on any OS.

git clone https://github.com/P2GX/ontologizer-gui.git
cd ntologizer-gui
npm install
npm run tauri build
The built installers will appear under: 
src-tauri/target/release/bundle/

Prerequisites

Node.js (at least version 18) and npm (at least version 9).

You can check if you have them installed via

node -v
npm -v

If necessary, go to https://nodejs.org to install these programs.

Rust and Cargo

See https://rustup.rs if needed.

Git

If you do not have git installed, replace the cloning step with a download of the archive.

Platform-specific code

Please report any dependencies not listed above.

Running the app

  1. Clone from GitHub 

    git clone https://github.com/P2GX/ontologizer-gui.git
cd ntologizer-gui.

  2. Install npm dependencies From within the ntologizer-gui directory, enter 

    npm install

  3. Running the app 

    npm run tauri dev

This will run the application.