Recern
Download
Recern Workspace · Documentation

Getting started

Install

Recern Workspace 1.0.0 is a desktop app for macOS, Windows and Linux. Download it from the download page:

  • macOS: a signed and notarized .dmg for Apple silicon and Intel. Open it and drag Recern to Applications.
  • Windows: an installer for Windows 10 and 11 (x64). Version 1.0.0 has no Authenticode signature, so Windows may show an unknown-publisher warning. Download from recern.net, compare the published SHA-256 checksum, then use More info → Run anyway if you trust the download. Tauri update signatures are separate and remain required.
  • Linux: an AppImage and a .deb package for x86_64. Make the AppImage executable with chmod +x, or install the .deb with apt.

From version 0.1.0 Recern updates itself: it checks for a new version shortly after launch and every few hours, downloads it in the background, and installs it when you choose Restart to update in the sidebar. Every update is signed, and Recern refuses one that does not match its key. Settings › Updates checks right away or turns this off. Workspace 1.0.0 requires a successful local settings checkpoint before installing an update; if it fails, the verified download remains available for retry. See Backups & recovery.

Add a connection

  1. Click + next to Connections in the sidebar, or press ⌘N.
  2. Choose PostgreSQL, MySQL, Microsoft SQL Server, MongoDB, ClickHouse, Cassandra, Qdrant, OpenSearch, Redis · Valkey · Dragonfly, SQLite or Recern Vector.
  3. Give the connection a name and an environment, fill in the address (or choose a local file for SQLite and Recern Vector), and enter the password or Qdrant API key if the server needs one.
  4. Click Test connection to check the settings without saving, then Save and connect.

Recern connects right away and opens the connection's first view. Redis, Valkey and Dragonfly are told apart when you connect, and the sidebar shows each one with its own icon.

The dashboard

Dashboard at the top of the sidebar (⌘1) shows every connection at once: engine-specific metrics and the findings that are open on each. Cassandra, Qdrant, OpenSearch and Microsoft SQL Server show measured request latency; this is not server CPU, memory or throughput. The dashboard groups connections by environment, with production first. The sidebar can group them by environment or by your own named groups.

Findings across all connections are listed below the cards, critical ones first. Each finding links to the view that explains it.

Next