NanumOS

zcloud — the same vault on every device

NanumOS, Mac, Linux and phones share one vault (zeus.kdbx) through the zcloud server (the zcloud box). The server only ever gets the file KeePass already encrypted with your master password — neither the server nor anyone in between can read it.

On NanumOS

  1. In a terminal: vault zcloud join ADDRESS DEVICE — type the device password (hidden). You join only if the server accepts it.
  2. The first time: vault zcloud sync — type the master password; the server's vault comes down and opens.
  3. From then on it is automatic: opening the vault takes the other devices' changes, and adding, editing or deleting an entry sends it at once.
  4. vault zcloud status — server, device, last sync and its result. vault zcloud leave — take this device out (the vault stays).

The Settings page (Settings › zcloud)

The same thing without commands. Settings › zcloud:

  1. Not joined yet: type the server address, device name and device password (hidden) and press Join. You join only if the server accepts it; a wrong password leaves nothing behind. The password never appears on screen or in a log.
  2. Once joined the page shows the server, the device name and the last sync (minutes ago, ok or failed, how many entries were added, updated, deleted; the reason when it failed).
  3. Sync now works while the vault is open (when it is locked, open it in the Vault app first). The desktop keeps painting meanwhile and Esc cancels.
  4. Leave takes this device out (the vault stays); the join form comes back.

Under the Vault app a joined device shows zcloud: 3 min ago synced. NanumOS Mobile has nothing to join — the Vault app finds the vault in your zcloud and asks only the master password, once (the Vault app manual, "On mobile"). The Zeus app's os_check has a "zcloud" row: not joined · last sync N minutes ago (healthy) · older than 24 hours (caution) · last result failed (fault, with the reason) · not measurable (?).

On Mac and Linux

The master password is asked each time, or read from a mode-600 file named by KX_PW_FILE.

On Windows

zcloud.exe (Windows 7 or later, 64-bit, command line) — the same join, sync, status, leave as on Mac and Linux. Its settings live in %USERPROFILE%\.config\zcloud.

Phones and other KeePass apps

In KeePassium (iPhone), KeePassDX (Android), KeePassXC or Strongbox, choose WebDAV and give the same address, device name and device password: they open the same vault, and merge with the server copy when they save.

When two devices disagree

If two devices change the same entry, the later change stays and the other is kept in that entry's History — nothing is lost. A deleted entry goes to the Recycle Bin everywhere unless another device changed it after the deletion. Device clocks should be right.

Safety

Removing a device

Delete its account on the server (administrator: device.sh revoke DEVICE); it is refused at once.

Files — photos, music, videos, documents

open; Del = zcloud trash, 30 days; File › Upload to zcloud) · vault zcloud files trash | versions PATH | restore PATH ·

NanumOS 0.1.8349 · 2026-11-16