khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2026-01-02 17:59:36 +07:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #10388 from nextcloud/fix/occ-decrypt-all

Browse Source 
fix: occ encryption:decrypt-all handles maintenance mode and disables…
This commit is contained in:
max-nextcloud
2023-05-15 15:08:26 +02:00
committed by GitHub
parent 1280705229 a3e19e6217
commit ff1f285747
1 changed files with 9 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
admin_manual/configuration_files/encryption_configuration.rst
View File

@@ -274,17 +274,19 @@ Disabling encryption
--------------------
You may disable encryption only with ``occ``. Make sure you have backups of all
encryption keys, including users'. Put your Nextcloud server into
maintenance mode, and then disable your encryption module with these commands::
encryption keys, including users'.
Disable your encryption module with this command::
occ maintenance:mode --on
occ encryption:disable
occ encryption:decrypt-all
Take it out of maintenance mode when you are finished::
It will put your server into maintenance mode and back.
It also takes care of disabling encryption when all files have been decrypted.
If the command is aborted some files have been decrypted and others are still encrypted.
In this case the command will keep the encryption turned on
and Nextcloud can handle this situation fine.
You can proceed decrypting the remaining files by calling the command again
once the problems that caused the abortion have been resolved.
occ maintenance:mode --off
.. warning:: Disabling encryption without decrypting all the files will lead to decryption errors in the future as this state causes unpredictable behaviors.
.. note:: The ``occ encryption:decrypt-all`` can take a lot of time. You can run one user at a time like so: ``occ encryption:decrypt-all <user-id>``.