Skip to the content
mantichora_/docs

Install and first start

One file to install on each system, one question at the first start, and after that the application keeps itself up to date when you let it.

Pick the file

The download page lists the files of the current release.

WindowsThe .exe installer puts Mantichora in your own account and needs no administrator. The .msi package installs it for every account on the computer and asks for an administrator. Both are 64-bit.
macOSOne .dmg disk image, for Apple silicon and Intel alike.
LinuxAn AppImage that runs as it is, or a .deb package for Debian and Ubuntu. Both are x86_64.

On Windows

Open the installer. The beta is not signed yet, so Windows may say it protected your PC: choose More info, then Run anyway. Before it installs anything, the installer shows the licence agreement and goes on once you accept it. Mantichora runs in WebView2, which Windows 11 already has; where it is missing, the installer fetches it.

On macOS

Open the disk image and drag Mantichora to Applications, then open it. The beta is not notarised yet, so macOS says it cannot check the developer. Open System Settings → Privacy & Security and choose Open Anyway under Mantichora.

NoteIf there is no such button, run xattr -dr com.apple.quarantine /Applications/Mantichora.app in Terminal and open it again.

On Linux

Make the AppImage executable and open it:

chmod +x Mantichora_*_amd64.AppImage
./Mantichora_*_amd64.AppImage

Or install the package, which has apt bring WebKitGTK 4.1, GTK 3 and the ODBC library with it:

sudo apt install ./Mantichora_*_amd64.deb

The build is made on Debian 12, so the system needs to be at least that new.

The first start

If the copy you installed can send crash reports or usage counts, the window asks once: Help make Mantichora better? Both boxes start unticked, and nothing is sent unless you tick one. Send nothing and Save both close the question for good; Settings → Privacy changes either answer later. The support page says exactly what each would send.

With no connection saved yet, the window offers three ways in: Make one here opens the connection form, Take one from another application imports connections from DataGrip or TablePlus, and New database file makes a SQLite file and a connection to it. Your first connection walks through the form.

Updates

Once a day the application reads one file from this site, the description of the newest release. When there is a newer version, a window says Mantichora 0.x is available with its notes. Install downloads it, checks its signature and restarts into it, asking first about anything unsaved, the way closing the window does; Later leaves it.

Settings → About has the switch Check for updates automatically and the button Check now, which asks at once.

Where it keeps things

Connections, history, settings and themes live in one folder, logs in another. Passwords are not in either: they are in the system’s store (see Passwords and the secret store).

systemdatalogs
Windows%APPDATA%\dev.mantichora.desktop%LOCALAPPDATA%\dev.mantichora.desktop\logs
macOS~/Library/Application Support/dev.mantichora.desktop~/Library/Logs/dev.mantichora.desktop
Linux~/.local/share/dev.mantichora.desktop~/.local/share/dev.mantichora.desktop/logs

Only one copy runs at a time: starting it again brings the open window to the front.