User Guide

Everything you need to know to get started with HybridCipher

⚡Quick Start Overview

  1. 1.Install HybridCipher and click Get started. Personal needs no account.
  2. 2.Save your recovery kit and recovery key somewhere other than this computer
  3. 3.Protect a folder—its files are encrypted in place using hybrid post-quantum cryptography
  4. 4.Mount the folder and work in Finder or File Explorer as usual—decryption is transparent

Prefer screenshots? Follow the Personal guide, or the Team admin guide if you run a Team.

Installation

Note: The beta is available for Apple Silicon Macs and Windows x64. Each build includes Personal and Team.

💻Supported Platforms

HybridCipher is available for:

  • macOS - Apple Silicon, macOS 12.0 or later; download the beta installer from the download page
  • Windows - x64, Windows 10 build 19041 or later or Windows 11; install from Microsoft Store. Protected folders use native Explorer integration and require NTFS.
  • Linux - Planned desktop build
  • Command Line - Planned packaging for automation and server workflows

Current packages and release notes are available from the download page.

First-Time Setup

Personal Setup (No Account Needed)

The first time you open HybridCipher, it sets itself up on this computer. Click Get started and follow the checklist on Home:

  • Save your recovery kit: Save the kit file (.hcrk) somewhere other than this computer, keep the recovery key the app shows you, and confirm its last 4 characters
  • Protect your first folder: Choose any folder you want HybridCipher to protect. Its files (and newly added files) are encrypted automatically.
  • Open it in Finder or File Explorer: Mount the folder and work with your files as usual

Optional: Create an Account

An account lets you use your protected files on other devices, and is needed to run or join a Team. Click Create account on Home; the folders you already protected become part of the account without being re-encrypted.

  • Email and password: Sign-in uses OPAQUE, so your password never reaches our servers
  • Recovery key: Paste the recovery key you saved during setup; it keeps working for the account
  • Enable two-factor authentication: Strongly recommended to avoid getting locked out during device changes or account recovery

⚠️ Critical: Secure your recovery kit and recovery key

HybridCipher uses zero-knowledge encryption, which means we cannot recover your account or decrypt your files if you lose your recovery kit and recovery key. Keep them apart—for example, the kit file on a USB drive and the key in a password manager—and never share them with anyone, including HybridCipher. HybridCipher does not keep a copy of either.

💡 Account Security Best Practices

  • Use a long passphrase (4–6 random words) or a password manager-generated password
  • Enable two-factor authentication and keep recovery codes offline
  • Keep your devices updated and protected (operating system updates, screen lock, disk encryption)

Note: This beta documentation covers the current onboarding flow and will expand as additional desktop builds and recovery guidance ship.

Basic Usage

📂 Protect a Folder

In the app, click Add Protected Folder and choose any folder on your device. A command-line tool is planned but not packaged yet.

  • Choose any folder: pick a location that fits your workflow
  • Existing files are protected too: files already in the folder are encrypted after you add it
  • Ongoing protection: files added later are encrypted automatically

🔒 How Encryption Works

After enrollment, HybridCipher continuously protects the folder by encrypting file data and managing keys on your devices.

  • Files inside the protected folder are encrypted automatically (including files added later)
  • Each file uses its own randomly generated file key
  • In a team, access is governed by the group’s current epoch (and rekeying when membership changes)
  • You keep working with files normally; encryption and decryption are handled by HybridCipher

☁️ Works With Any Cloud Sync Folder

HybridCipher does not replace your cloud provider. It encrypts locally, and your existing sync tool uploads what is in the folder.

  • Enroll a folder that is inside a synced path (for example, Google Drive, Dropbox, OneDrive, Nextcloud, Syncthing)
  • Your provider stores and syncs the folder contents; HybridCipher’s goal is for those contents to be encrypted
  • You can switch providers by moving the protected folder into a different sync path (no format lock-in)

✅ Designed so storage providers store encrypted data; during beta, follow the recommended workflow to avoid timing races.

🔄 Use on Multiple Devices

To access the same encrypted data on another device, install HybridCipher there and connect it to the same synced folder.

  • Install HybridCipher on each device you want to use
  • Sign in to your account (create one first from Home if you started without one)
  • If you use Team, an owner or admin approves the new device before it receives group keys
  • Point HybridCipher to the same synced folder location
  • Files remain encrypted at rest and decrypt only on authorized devices

Team

👥 Same App, One Code

Team is part of the same HybridCipher app. A Team code adds an organization to your account, and Personal stays available.

  • Owners: open Settings → Activate Team and enter the organization name and your single-use Team code (request one)
  • Members: accept the invitation on Home, or paste the invitation code under Joining an existing Team? and click Join Team. Invitations expire after 7 days.
  • Roles: organizations and groups each have owners, admins, and members. Team administration works only from a verified device.

🔑 Groups and Group Keys

Groups decide who can open which files. Each group has its own keys, and a group's protected folders are encrypted with them.

  • Files are protected with per-file keys; access is governed by the group's current epoch (key version)
  • New devices wait for approval by an owner or admin before they receive the group's keys
  • Keys are shared only between devices; there is no key escrow

🚫 Removing Access

  • Remove access on a group's People tab rotates the group's keys in the same step, so the person can't open files added from now on
  • Access to files they could open before depends on whether those files have been re-encrypted under the new keys
  • Remove from Team frees their seat and takes them out of their groups, but doesn't rotate keys by itself. The app then offers to rotate the keys of each group you manage; you can also do it later from the group's Keys & security tab.

✅ Cryptographic revocation: access is enforced by keys, not only by server-side permissions

📘 Step-by-step

The Team admin guide walks through creating groups, inviting people, protecting a shared folder, approving devices, and removing access, with screenshots.

Getting Help

HybridCipher is actively evolving during beta. If you encounter issues or have questions:

📧 Contact Support

  • • Email: [email protected]
  • • Include the exact build version and steps to reproduce the issue
  • • Include your operating system, HybridCipher version, and a description of the issue

📚 Additional Resources

💬 Feedback & Feature Requests

Your feedback shapes the product roadmap. Share suggestions, report bugs, or request features at [email protected]

Security Best Practices

DO: Keep your recovery kit and recovery key safe

They are the only way to open your files if this computer is lost. Keep them apart, away from this computer.

DO: Enable MFA (two-factor authentication)

If you have an account, click Enable MFA in Settings → Security.

DO: Rotate keys when someone leaves

After removing someone, rotate the group's keys so they can't open files added from now on. Rotation is manual and takes effect at once.

DON'T: Share your recovery kit or key

Never share your recovery kit, recovery key, or recovery code, including with HybridCipher. Use Team to share files securely.

DON'T: Forget to remove ex-employees

When someone leaves, remove them from teams immediately to revoke access.