Skip to content

docs(admin): add occ_encryption.rst with complete encryption command docs#14560

Merged
miaulalala merged 1 commit intomasterfrom
docs/admin-occ-encryption-completeness
Apr 24, 2026
Merged

docs(admin): add occ_encryption.rst with complete encryption command docs#14560
miaulalala merged 1 commit intomasterfrom
docs/admin-occ-encryption-completeness

Conversation

@miaulalala
Copy link
Copy Markdown
Contributor

@miaulalala miaulalala commented Apr 23, 2026

Extract the encryption section from occ_files.rst into its own page and document all 18 encryption commands (previously only 12 were covered). Add per-command headings with verbose examples, fix four inaccuracies in the existing docs (encrypt-all maintenance mode, decrypt-all command typo, disable maintenance note, enable-master-key disable claim), and add 6 previously missing commands: disable-master-key, fix-encrypted- version, fix-key-location, migrate-key-storage-format, recover-user, and scan:legacy-format. Add strong warnings around master key mode switching: permanent data loss if done with existing encrypted data, performance regression, and loss of admin decryption with per-user keys.

AI-Assisted-By: claude-sonnet-4-6

🖼️ Screenshots

screencapture-file-home-anna-Documents-documentation-admin-manual-build-html-com-occ-encryption-html-2026-04-24-15_26_36 Screenshot from 2026-04-24 15-26-57

…docs

Extract the encryption section from occ_files.rst into its own page and
document all 18 encryption commands (previously only 12 were covered).
Add per-command headings with verbose examples, fix four inaccuracies in
the existing docs (encrypt-all maintenance mode, decrypt-all command
typo, disable maintenance note, enable-master-key disable claim), and
add 6 previously missing commands: disable-master-key, fix-encrypted-
version, fix-key-location, migrate-key-storage-format, recover-user,
and scan:legacy-format. Add strong warnings around master key mode
switching: permanent data loss if done with existing encrypted data,
performance regression, and loss of admin decryption with per-user keys.

AI-Assisted-By: claude-sonnet-4-6
Signed-off-by: Anna Larch <anna@nextcloud.com>
@miaulalala miaulalala force-pushed the docs/admin-occ-encryption-completeness branch from 1de4792 to ca6ad1e Compare April 24, 2026 13:22
@miaulalala miaulalala marked this pull request as ready for review April 24, 2026 13:27
@miaulalala miaulalala merged commit b67c703 into master Apr 24, 2026
24 checks passed
@miaulalala miaulalala deleted the docs/admin-occ-encryption-completeness branch April 24, 2026 14:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants