Install

Get the installer for your system from the download page. Everything Olyvr needs is bundled: you do not need Python, Node.js or any other runtime.

macOS

Requires macOS 15 or later. Apple Silicon and Intel Macs use different downloads; pick the one that matches your Mac.

1. Open the downloaded .dmg and drag Olyvr Workspace into Applications.

2. The current build is not notarized by Apple, so double-clicking it the first time shows a warning. Instead, open Applications, right-click (or Control-click) Olyvr Workspace, choose Open, then confirm Open.

   If macOS still refuses, open System Settings → Privacy & Security, scroll down, and click Open Anyway next to the Olyvr message.

3. Olyvr opens to a new chat. Continue with the quickstart.

On macOS, Olyvr can list your running apps and check whether it has the Accessibility permission, without changing anything. Window control, which will need that permission, is still in development. You can grant it in System Settings → Privacy & Security → Accessibility.

Windows

Requires 64-bit Windows.

1. Run the downloaded .exe. It installs for your user account only, so it does not need administrator rights. You can choose the install folder.

2. The installer is not yet code signed, so Microsoft Defender SmartScreen may show Windows protected your PC. Click More info, then Run anyway.

3. Open Olyvr Workspace from the Start menu and continue with the quickstart.

Linux

Requires 64-bit (x86_64) Linux with a reasonably recent glibc.

1. Make the AppImage executable:

   chmod +x Olyvr-Workspace-*.AppImage

2. Run it:

   ./Olyvr-Workspace-*.AppImage

   If it fails to start with a FUSE error, install your distribution’s libfuse2 package.

3. Continue with the quickstart.

Verify the download

Each card on the download page lists a SHA-256 checksum. Compare it with the checksum of the file you downloaded:

macOS

shasum -a 256 ~/Downloads/Olyvr-Workspace-*.dmg

Windows

Get-FileHash $env:USERPROFILE\Downloads\Olyvr-Workspace-*.exe -Algorithm SHA256

Linux

sha256sum Olyvr-Workspace-*.AppImage

If the values differ, delete the file and download it again.

Where Olyvr keeps your data

OS	Folder
macOS	~/Library/Application Support/Olyvr Workspace
Windows	%APPDATA%\Olyvr Workspace
Linux	~/.config/Olyvr Workspace

This folder holds your imported documents, chats, search index, settings and encrypted credentials. Back it up to keep your workspace; delete it to start fresh. Data and privacy describes what is inside.

Note

If you used an earlier build named Olyver Workspace or Oliver Workspace, Olyvr moves that folder to the new location on first launch.

Uninstall

• macOS: quit Olyvr and drag it from Applications to the Trash.
• Windows: Settings → Apps → Installed apps → Olyvr Workspace → Uninstall.
• Linux: delete the AppImage.

Uninstalling leaves your data folder in place. Delete it yourself if you want to remove your workspace too.