Skip to main content
Luminy is distributed as a native desktop application built with Tauri, which means you get a single, self-contained installer for your platform — no package managers, no runtimes, and no build steps required. This page covers how to download and install Luminy on any supported operating system and explains how the built-in auto-updater keeps your installation current.

​
System requirements

Luminy is a lightweight native app and runs comfortably on any modern machine meeting the following requirements.
RequirementDetails
Operating systemmacOS 11 (Big Sur) or later · Windows 10 or later · Major Linux distributions (Ubuntu 20.04+, Fedora 37+, Arch, etc.)
Architecturex86-64 or Apple Silicon (arm64)
Disk space~80 MB for the app bundle; additional space for your project indexes and session database
Node.js / RustNot required — the app is fully bundled. No developer toolchain needed for end users.
If you want to use local AI models through Ollama, you will need Ollama installed separately and enough RAM to run your chosen model. Ollama itself is not bundled with Luminy.

​
Download

Visit luminy.tech and click the download button for your platform. The site auto-detects your OS, but you can also scroll down to choose a specific platform or architecture manually. The current release is v1.5.4.

​
Installation

1

Open the disk image

Double-click the downloaded .dmg file to mount it. A Finder window will open showing the Luminy app icon alongside a shortcut to your Applications folder.
2

Drag to Applications

Drag Luminy.app into the Applications folder shortcut. Wait for the copy to finish.
3

Launch Luminy

Open Launchpad or navigate to /Applications in Finder and double-click Luminy to launch it.
4

Allow the app to run (first launch only)

On the very first launch, macOS Gatekeeper may show a warning because the app was downloaded from the internet. Click Open in the dialog to proceed. You will not see this prompt again.
If macOS says it “cannot be opened because the developer cannot be verified” and does not show an Open button, right-click (or Control-click) Luminy.app in Finder and choose Open from the context menu. This bypasses Gatekeeper for that first launch only.

​
Automatic updates

Luminy includes a built-in auto-updater powered by signed release artifacts hosted at https://luminy.tech/api/updates. Here is how it works.
  • Background checks — When Luminy is running, it periodically polls the update endpoint for new releases.
  • Silent download — If a new version is available, Luminy downloads the update in the background without interrupting your work.
  • Prompt to restart — Once the download is complete, Luminy shows an unobtrusive notification asking whether you want to restart and apply the update now or wait until the next time you open the app.
  • No manual action needed — You never need to visit the download page again after the initial install.
All update artifacts are cryptographically signed. Luminy verifies the signature before applying any update, so you are protected against tampering.
Auto-updates are supported on macOS and Windows out of the box. On Linux, auto-updates are available for AppImage installs. If you installed via .deb or .rpm, update through your system package manager or re-download from luminy.tech when a new version is released.

​
Troubleshooting

This is macOS Gatekeeper blocking an app that hasn’t been opened before. Right-click (or Control-click) Luminy.app in Finder, choose Open from the context menu, then click Open in the dialog that appears. You only need to do this once — future launches will open normally.
Windows SmartScreen may flag newly published executables. Click More info and then Run anyway to proceed. This prompt disappears once the app has been run enough times to build a reputation with Microsoft’s system.
Make sure the file has executable permissions (chmod +x Luminy_*.AppImage). On some distributions you may also need to install libfuse2 — for example, on Ubuntu 22.04+: sudo apt install libfuse2.
Try deleting the app’s local data directory and relaunching. On macOS this is ~/Library/Application Support/Luminy; on Windows it is %APPDATA%\Luminy; on Linux it is ~/.config/Luminy. This resets Luminy to a clean state without uninstalling it.