Documentation Menu

Desktop app

Native Windows/macOS/Linux app for managing services + softphone.

The Suzko Desktop app puts your dashboard, softphone, and service controls in a native window. Built on Tauri (small, fast, no Chrome runtime).

Why use it

  • Softphone — calls + SMS in a dedicated window, with native notifications.
  • Service quick-actions — power buttons, console access without a browser tab.
  • Always-running — minimize to tray, get notified of new invoices, tickets, calls.
  • Native auth — sign in once, stays signed in via secure token storage.

Download

/downloads. Pick your OS:

  • Windows 10+.exe installer (NSIS) or .msi for managed installs
  • macOS 11+.dmg for Intel / Apple Silicon (universal build)
  • Linux.AppImage (universal), .deb (Debian/Ubuntu), .rpm (Fedora/RHEL)

First-time sign-in

  1. Launch the app.
  2. Click Sign in with browser.
  3. Your default browser opens to /auth/device — sign in or use an existing session.
  4. Click Authorize.
  5. Browser deep-links back to the app. You're in.

The app stores an encrypted device token. You stay signed in until you explicitly sign out.

Updates

Update banner appears in the app when a new version is available. Click → opens /downloads in your browser to grab the installer. Manual install over the existing one — your sign-in persists.

Permissions

The app asks for:

  • Microphone — for the softphone
  • Notifications — for incoming calls / messages
  • Auto-start at login — optional, in Settings

Nothing else.

Multiple devices

Sign in to as many devices as you want — each gets its own token. Inbound calls ring all signed-in devices simultaneously; first to answer wins.

Signing out

Profile → Sign out. Revokes the device token immediately. Other signed-in devices keep working.

Troubleshooting

  • App won't open after install (macOS) — Gatekeeper. Right- click the app icon → Open. One-time prompt.
  • App won't open after install (Windows) — SmartScreen. Click "More info" → "Run anyway". Microsoft hasn't trust-rated us enough yet.
  • Softphone is offline — check Settings → Audio devices; the app needs mic access. Restart the app to re-register.
  • Deep-link sign-in doesn't return — close the browser tab and open the app again; it'll check for a pending auth code on startup.