# Offline Secrets Manager

One encrypted vault. No network.

- Author: [Konstantinos Toulis](https://ktoulis.com/#about)
- Role: Business Technology & AI Solutions Architect
- Category: Digital platforms
- Project type: Source-available macOS app
- Canonical page: https://ktoulis.com/work/secrets-manager.html

## Overview

PrivateVault is a secrets manager for macOS that works entirely offline: logins, API credentials, secure notes, recovery codes and crypto-wallet seed phrases live in one encrypted vault file on the Mac, and the app cannot open a network connection.

## The business challenge

Keep the most sensitive secrets, from passwords and API keys to wallet seed phrases, without trusting a cloud service, and make a copied vault file or backup useless to whoever takes it.

## The connected solution

Every record is encrypted with AES-256-GCM, including its type, title and timestamps. The key that opens the vault is built from two secrets: the Master Password, stretched with Argon2id, and a random 256-bit Secret Key that is never stored in the vault file. That key is kept in the macOS Keychain, wrapped by the Secure Enclave, and printed once as a paper Recovery Kit, so a stolen file or backup cannot even be used to guess the password. Seed phrases and private keys stay in an inner encrypted box until a Reveal confirmed with Touch ID or the login password. A keyed check detects deleted or rolled-back records, and the vault locks itself when idle and wipes its keys from memory. The app ships without the network entitlement, so macOS blocks every connection: no telemetry, no update check and no sync.

## The workflow

1. Create the vault
2. Print the Recovery Kit
3. Unlock & auto-lock
4. Back up encrypted

The workflow is an illustration. Project scope and limitations are described below.

## Built with / focus areas

- Swift
- SwiftUI
- CryptoKit
- Argon2id
- Secure Enclave & Keychain
- SQLite

## Focus

- Source available
- Zero-knowledge vault
- Offline by design
- macOS security

## Scope and disclosure

Source-available under the Functional Source License (FSL-1.1-ALv2), which is not an open-source licence; each version becomes Apache 2.0 two years after its release. Version 1.0 is published as source to review: signed downloads are not available yet, and the security audit in the repository is a self-audit, not an independent one. By design nobody, the author included, can recover a forgotten Master Password, and an unlocked vault is not protected from malware on the same Mac.

## Explore further

- [Explore the source](https://github.com/toul10/privatevault)

## Contact

[Discuss a similar project by email](mailto:kt@ktoulis.com).

[All selected work](https://ktoulis.com/#work) · [Professional profile](https://ktoulis.com/index.md)
