Installation Notes

The main installation instructions are on the Download page. Additional notes related to installation are collected on this page.

General

Upgrading

Ultorg will occasionally notify you of new available versions. To check immediately, click Help→Check for Updates. To upgrade, download the latest version, and follow the regular installation instructions. The Release Notes page lists changes in each version.

Updates are optional; existing Ultorg installations will usually continue working indefinitely.

Moving to a Different Computer

To move saved perspectives and data source configurations) to a different computer, use the Export Perspectives feature. You can deactivate the old installation to free up its license.

Windows

See the main installation instructions for Windows here.

Uninstalling

You can uninstall Ultorg from Programs and Features in the Control Panel. Saved perspectives and data source configurations will remain available in case you later install Ultorg again.

MSI Installer Options

Ultorg's windows installer is an MSI file which can be run either interactively or from the command line. To install Ultorg from a batch script or similar, use the following command:

msiexec /i /quiet ultorg-0.0.0-win_x64.msi

Replace 0.0.0 with the Ultorg version you are installing. If an older Ultorg version is already installed, it will be automatically upgraded.

By default, Ultorg is installed for the current user only. This avoids the need for administrator rights. If a machine-wide installation is desired, you can use the following command:

msiexec ALLUSERS=1 /i ultorg-0.0.0-win_x64.msi

This will install Ultorg into C:\Program Files\Ultorg instead of the user's home directory. Administrator rights are required for this kind of installation, and for later upgrades.

Integrated Authentication

Some data sources support passwordless login using the credentials of the current Windows user. This is useful e.g. in corporate environments that use Active Directory for single sign-on. For more information, see the documentation page for your specific database:

MacOS

See the main installation instructions for MacOS here.

One user reported Ultorg failing to start after a hard reset (power loss). This rare issue was solved by deleting the file ~/Library/Application Support/ultorg/prod1/lock

Linux

See the main installation instructions for Linux here.

DPI Scaling

For screens with high pixel density (HiDPI displays), Ultorg can render its user interface at a higher resolution. You can usually configure this through your desktop environment.

A scale factor of exactly 200% is supported on both GNOME and KDE.

Fractional scale factors, such as 150%, are supported on GNOME 48 and above (ships with e.g. Ubuntu 25.04), including on multi-monitor setups with different scale factors. You can check your GNOME version with the command below.

gnome-shell --version

You can also scale individual perspectives with the Zoom (Zoom In icon Ctrl+Plus) feature.

Per-monitor and fractional DPI scaling is also fully supported on Windows and MacOS.