Install QueryLane

System requirements

• A Mac with Apple silicon (M1 or later). QueryLane is not built for Intel Macs.
• macOS 13.5 Ventura or later.

Install

1. Download the QueryLane disk image (QueryLane_<version>_aarch64.dmg).
2. Open the .dmg file.
3. Drag QueryLane to the Applications folder in the window that opens.
4. Eject the disk image.

Always start QueryLane from the Applications folder, not from the disk image.

Open QueryLane the first time

QueryLane is signed without an Apple Developer ID and is not notarized, so macOS blocks the first launch and says it could not verify the app. You allow it once, and later launches open normally.

On macOS 15 Sequoia and later:

1. Open QueryLane from the Applications folder. When macOS blocks it, click Done.
2. Open System Settings > Privacy & Security.
3. Scroll to the Security section. Next to the message about QueryLane, click Open Anyway. The button stays there for about an hour after the blocked launch.
4. Confirm with Open Anyway and enter your Mac password.

On macOS 13 Ventura and macOS 14 Sonoma you can also Control-click QueryLane in the Applications folder, choose Open, and click Open in the dialog.

If macOS says QueryLane is damaged

Sometimes macOS says QueryLane “is damaged and can’t be opened” and offers to move it to the Trash. The app is fine: macOS marks everything downloaded from the internet, and for apps without an Apple Developer ID it may report that mark as damage. There is no Open Anyway button in this case.

Remove the mark in Terminal, then open QueryLane as usual:

xattr -dr com.apple.quarantine /Applications/QueryLane.app

First launch

QueryLane opens on the Jobs panel. The narrow rail on the left switches between Jobs, Connections and Settings. Start by adding a database in Connect a database.

Updates

QueryLane checks for updates shortly after it starts and then once a day. It installs only update packages signed with the QueryLane update key.

When a new version is available, a download button appears at the bottom of the left rail. If QueryLane may send notifications, you also get a QueryLane update available notification. Click the button or the notification, or click Update now in Settings > Updates. QueryLane downloads the update, installs it and restarts.

In Settings > Updates you can:

• turn off Enable updates to stop all update checks;
• turn off Check automatically and use Check now when you want;
• change Check interval from Every minute to Every month;
• send update requests through a proxy with Proxy mode;
• read the release notes with What's new.

Background item for schedules

Job schedules run even when QueryLane is closed. When you save the first schedule, QueryLane registers a background item with macOS: a launchd agent stored inside the app. The agent wakes up once a minute and starts a run only when a job is due. QueryLane removes the item when you delete the last schedule.

macOS lists the item in System Settings > General > Login Items (Login Items & Extensions on macOS 15 and later). If you switch QueryLane off there, scheduled jobs do not run. Check the state in Settings > Schedules > macOS background item, and use Open macOS settings to get to the system page.

The first schedule also asks for permission to send notifications. QueryLane uses them to report failed scheduled runs and result check warnings.

Where your data lives

QueryLane keeps everything in your user Library:

~/Library/Application Support/app.querylane.desktop/
├── profiles/main/stores/   connections, jobs, saved queries and settings (JSON)
├── results/                job run results
├── plugins/                installed plugins
├── user-packages/          npm packages for JavaScript steps
└── logs/                   application logs

To move your setup to another Mac, use Settings > Backups. It exports connections, jobs, saved queries and settings to an encrypted .enc file.