ProPR
Log in Get ProPR

ProPR on your desktop.

ProPR Desktop puts a native window around the full ProPR web UI on Linux and macOS. Pair it with any ProPR server, keep several instances and GitHub accounts side by side, and work from native menus and a tray. On Linux it also shows native notifications and sets up a local ProPR stack for you.

Download 0.9.1View on GitHub

ProPR Desktop connecting to an instance: a display name, Northwind Labs, the instance URL and a Connect button
Add an instance, then approve the connection in your browser.

Setup overview

Download ProPR Desktop 0.9.1.

Preview builds, published as GitHub pre-releases for Linux and macOS, each with a SHA256SUMS file. Choose the package for your operating system and CPU.

No Windows build yet. The browser and the installable web app work on any platform.

Install on Linux.

Verify the download with the signed checksum file (Linux desktop release key), then install it with your package manager. Set ARCH to x64 or arm64.

ARCH=x64
gpg --verify SHA256SUMS.asc SHA256SUMS
sha256sum --check --ignore-missing SHA256SUMS
sudo apt install ./ProPR-Desktop-0.9.1-linux-$ARCH.deb   # Debian, Ubuntu
sudo dnf install ./ProPR-Desktop-0.9.1-linux-$ARCH.rpm   # Fedora, RHEL
propr-desktop

To update, install the newer package the same way.

Install on macOS.

Open the DMG and drag ProPR to Applications. The macOS build is unsigned and not notarized, so allow it once under System Settings → Privacy & Security → Open Anyway; macOS remembers the exception. To update, replace the app with the newer download.

Full macOS install steps in the docs.

Connect in three steps.

ProPR Desktop connects to a ProPR instance: your own server, a Connect managed tunnel, or a stack on the same machine.

Enter the address

Choose Connect Instance and enter the instance URL.

Approve in your browser

Sign in with GitHub in your default browser. The app never receives a GitHub token.

Confirm the account

A native dialog shows the GitHub @username that approved. Confirm it, and the app stores its instance token encrypted in the OS credential store.

What the native window adds.

Instances and accounts

Save several instances and several GitHub accounts, including two accounts on the same instance. Switch from the instance manager.

Native menus and shortcuts

Every menu action has a keyboard shortcut: jump to Dashboard, Inbox, Plans, Goals, Tasks and Repositories, or start a task, plan, goal, automation or to-do from anywhere. On Linux, the application menu button opens the same menus.

Tray and notifications

The tray shows task and plan counts. On Linux, native notifications flag failed tasks and work that needs you; switch them on per device.

Sandboxed renderer

The web UI runs without Node, shell or file-system access. The main process holds credentials, encrypted at rest.

App and server, versioned apart

About ProPR shows the app version and Connection Diagnostics show the server's. Updating the app never upgrades the server.

Run ProPR on this computer.

On Linux x64, choose Set up this computer on first launch. The wizard runs the same setup engine as propr setup: it checks Docker and the host, signs you in to GitHub through your browser, asks for your coding agents and event intake, pulls the images that match this release, starts the stack, and opens browser pairing for you to approve.

Local setup in the docs.

Requirements

  • Docker without sudo

    Docker Engine running, and your user able to run docker info.

  • Network access

    GitHub and Docker Hub, for the repository and the prebuilt images.

  • A terminal emulator

    GNOME Terminal, Konsole, xterm or your distribution's default, for coding-agent logins.

  • Linux x64

    ProPR builds its runtime images for x64. arm64 Linux and macOS connect to an existing instance.

Prefer the browser?

Install the web UI as an app from your browser for push notifications and a home-screen icon. ProPR on mobile

Everything else is in the docs.

The desktop documentation covers keyrings, pairing, local setup recovery and uninstall.