The operations portal,
as a Mac app.

Install

Open the downloaded .dmg, drag RideNear Portal into Applications, then eject the disk image.

Allow it to open

The app is distributed privately rather than through the App Store, so macOS stops it the first time. Open it once from Applications, then:

1. Open System Settings → Privacy & Security and scroll to Security.
2. Next to "RideNear Portal was blocked", click Open Anyway and confirm.

If macOS instead says the app "is damaged and can't be opened", clear the download flag in Terminal and open it again:

xattr -dr com.apple.quarantine "/Applications/RideNear Portal.app"

This is needed only on the first launch. Updates install from inside the app.

Add the AI modeloptional

RideNear Intelligence, the assistant behind the ✦ button, runs entirely on your Mac and needs its model file, ridenear-intelligence-4b-q4_k_m.gguf (about 2.7 GB). Your administrator hands it out. Put it in this folder, where it survives app updates:

~/Library/Application Support/com.ridenear.portal/ai/models/

In Finder: Go → Go to Folder…, paste the path and create any folder that is missing. Or, with the file in Downloads, run:

mkdir -p "$HOME/Library/Application Support/com.ridenear.portal/ai/models" && cp ~/Downloads/ridenear-intelligence-4b-q4_k_m.gguf "$HOME/Library/Application Support/com.ridenear.portal/ai/models/"

Restart RideNear Portal. The app checks the file and switches the assistant on. Without it, every other screen works as normal.

Sign in

Use your admin email and password, the same ones as the RideNear dashboard. Access and roles are managed by an administrator in Settings → Admin access. No other setup is needed: there is no configuration file to install.