NanumOS

Encrypted folders

Keep files nobody else should see in a folder locked with a password. A locked folder is one file (NAME.zcrypt); without the password nobody can read what is inside.

What it is

Like a drawer inside a safe. Open the drawer (the encrypted folder) and use its files as usual; close it and it is locked again. While it is locked, the disk holds only unreadable bytes.

What to do now: in Files, choose File › New Encrypted Folder….

How to use it

  1. Make one — Files › File › New Encrypted Folder…: a name and a password (8 characters or more), twice. The new folder opens at once.
  2. Write down the recovery key — when it is made, a recovery key (13 groups of 4 characters) is shown once. Write it on paper and keep it away from the computer. If the password is forgotten, only this opens the folder.
  3. Put files in — drag or save files into the open folder (in the sidebar, under Encrypted).
  4. Lock it — right-click its row in the sidebar › Lock. Log out, restart, shut down and quitting the Mac app lock it by themselves.
  5. Open it again — double-click NAME.zcrypt in Files and type the password.

Opening with a vault entry: in the Terminal, cryptfolder vault-add NAME.zcrypt ENTRY lets that vault entry's password open it too. Files then asks the vault first (an allow sheet the first time) and the password only if that fails.

How it works

Technical details
  • Command: cryptfolder create|unlock|lock|status|info|passwd|recovery|vault-add|vault-remove (--help).
  • Format: a header (up to 8 key slots, HMAC-SHA256) + XChaCha20-Poly1305 64 KiB chunks (chunk number and last-chunk flag in the nonce, the header MAC as AD). All primitives are the vendored Monocypher / zcrypto ones.
  • While it is open the folder's key sits in the same /tmp place (0600) so it can be locked without the password. While it is open, programs of the same user can read the folder — lock it when done.
  • Contract: docs/contracts/CRYPTFOLDER.md.

Common questions

NanumOS 0.1.8349 · 2026-11-16