Skip to content

Desktop App

The desktop app is a Tauri v2 thin client around the Vite/React web application. It connects to an existing backend and does not start one.

Install Rust and the platform libraries required by Tauri:

Terminal window
scripts/install-desktop-deps.sh

Start the backend separately, then launch the client:

Terminal window
bin/octi start
bin/octi desktop

Use bin/octi desktop --build to rebuild the bundle, --foreground for attached logs, and --stop to stop the desktop process. The desktop flow signs in through the mobile login endpoint and stores the returned bearer credential in the client; protect the operating-system account and local application data accordingly.

The desktop development server uses a separate port from the browser UI. Consult docs/DESKTOP.md for current platform packages, signing, and packaging status.