\\ Reset Permissions Plugin For OMV8 [[omv8:omv8_plugins:resetperms|{{ :omv6:omv6_plugins:resetperms-logo.jpg?400 |Reset Permissions Plugin For OMV8}}]] ====== Reset Permissions Plugin For OMV8 ====== \\ \\ ===== Summary ===== [[omv7:nas_permissions_omv7|{{ :omv7:omv7_plugins:resetperms7-4.jpg?direct&200|NAS Permissions}}]] * **openmediavault-resetperms** provides a tool to **modify permissions of shared folders and all their content at the file system level** directly from the OMV GUI. The form displays a column with the services associated with each shared folder. * Modifying permissions can be useful if the file system comes from another system and you want to reset folder permissions, if you want to remove ACL permissions, or if you want to customize permissions for each shared folder. It can also be used to change the permissions of an existing shared folder. * This plugin does not modify permissions configured at the service level (Samba, NFS, etc.), only at the file system level. File system permissions take precedence if they are more restrictive. Once permissions are applied using this plugin, they can be further restricted through individual service settings. More detailed information is available in [[omv7:nas_permissions_omv7|NAS permissions in OMV 7]]. * **All changes applied using this plugin are recursive**, meaning they affect the selected folder and all its subfolders and files. ---- ===== Prerequisites ===== * [[https://wiki.omv-extras.org/doku.php?id=misc_docs:omv_extras|OMV-Extras]] must be pre-installed. ---- ===== Installation ===== In OMV8's GUI:\\ Under **System**, **Plugins**, find and highlight **openmediavault-resetperms 8.X**, and click the **Install** button. ---- ===== Using the Reset Permissions plugin ===== ---- === Reset Permissions === * Modify permissions of an existing folder ---- Under Services > Reset perms \\ {{ :omv8:omv8_plugins:resetperms1.png?direct&1000 |Reset Permissions 1}} ---- {{ :omv8:omv8_plugins:resetperms2.png?direct&600|Reset Permissions 2}} * Go to **Services** > **Reset Perms**. In this tab you can see a list of all shared folders on the system. To modify the permissions of a folder, do the following: * Select a folder from the list (highlighted in yellow). * Press the **Reset permissions** button. A dialog will open allowing you to modify the permissions of the selected folder. In this dialog: * In the **Permissions** field, select the permissions you want to apply. * To restore standard OMV permissions, select: ''Administrator - read/write, Users - read/write, Others - read-only''. * To remove ACL permissions from the shared folder, click the **Clear ACLs** button. By default, shared folders in OMV do not use ACLs. * Press the **Reset** button. Changes will be applied recursively to all subfolders and files. \\

Warning
This plugin can break your system if not used improperly. DO NOT CHANGE THE PERMISSIONS OF THE DISK WHERE THE OPERATING SYSTEM IS INSTALLED. Doing so may render the system unusable and require a full reinstallation. For the same reason, do not modify permissions of the folder where Docker is installed or the persistent data directories of containers.

---- === Shared Folder in Use === {{ :omv8:omv8_plugins:resetperms3.png?direct&600|Reset Permissions 3}} The **Services** > **Reset perms** tab displays all shared folders and several columns with useful information. One of these is the **In use by** column, which is especially helpful if you plan to delete a shared folder. * Delete a shared folder: * OMV does not allow deletion of a shared folder if it is in use by any service. In **Storage** > **Shared folders**, the delete icon will be disabled. * To delete a shared folder, you must first remove all services using it. Once the associated services are removed, the **Delete** button becomes available. * Unmount a file system: * The same logic applies to file systems. A file system cannot be deleted while shared folders exist on it. * To unmount a file system, first remove services using its shared folders, then delete the shared folders. After that, the **Unmount** button will become available in the OMV GUI. ---- ===== Source Code ===== -> [[https://github.com/OpenMediaVault-Plugin-Developers/openmediavault-resetperms|openmediavault-resetperms]] ---- ===== A Closing Note ===== We, who support the openmediavault project, hope you’ve found this guide to be useful and that you’ll find your openmediavault server to be efficient, easy to use, and enjoyable.\\ \\ If you found this plugin guide to be helpful, please consider a modest donation to support the hosting costs of this server.\\ \\ **OMV-Extras.org** \\ \\ \\ **Venmo: ryecoaaron** \\