{"id":13583119,"url":"https://github.com/optimans/cockpit-zfs-manager","last_synced_at":"2025-04-06T18:31:53.241Z","repository":{"id":217600393,"uuid":"224218874","full_name":"optimans/cockpit-zfs-manager","owner":"optimans","description":"Cockpit ZFS Manager is an interactive ZFS on Linux admin package for Cockpit.","archived":true,"fork":false,"pushed_at":"2021-07-30T08:08:32.000Z","size":877,"stargazers_count":255,"open_issues_count":14,"forks_count":69,"subscribers_count":17,"default_branch":"master","last_synced_at":"2024-11-05T23:41:28.365Z","etag":null,"topics":["cockpit","cockpit-zfs-manager","filesystems","nfs-share","samba-share","snapshots","storage-pools","zfs","zfsonlinux"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/optimans.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2019-11-26T15:01:17.000Z","updated_at":"2024-11-04T03:49:45.000Z","dependencies_parsed_at":"2024-01-17T11:10:04.370Z","dependency_job_id":"c1ef46cc-2f83-47d9-bcbb-7421946ddc6c","html_url":"https://github.com/optimans/cockpit-zfs-manager","commit_stats":null,"previous_names":["optimans/cockpit-zfs-manager"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimans%2Fcockpit-zfs-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimans%2Fcockpit-zfs-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimans%2Fcockpit-zfs-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimans%2Fcockpit-zfs-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/optimans","download_url":"https://codeload.github.com/optimans/cockpit-zfs-manager/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247531045,"owners_count":20953884,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cockpit","cockpit-zfs-manager","filesystems","nfs-share","samba-share","snapshots","storage-pools","zfs","zfsonlinux"],"created_at":"2024-08-01T15:03:16.093Z","updated_at":"2025-04-06T18:31:52.734Z","avatar_url":"https://github.com/optimans.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","others"],"sub_categories":[],"readme":"# Cockpit ZFS Manager\n\n[![GitHub Tag](https://img.shields.io/github/v/release/optimans/cockpit-zfs-manager?include_prereleases\u0026style=flat-square\u0026color=brightgreen)](https://github.com/optimans/cockpit-zfs-manager/releases)\n\n**An interactive ZFS on Linux admin package for Cockpit.**\n\nUse of this software is at your risk!\n\n## End-of-Life\n\nThis software has reached its end-of-life and is no longer maintained.\n\n## Requirements\n\n * Cockpit: 201+\n * NFS (Optional)\n * Samba: 4+ (Optional)\n * ZFS: 0.8+\n\n## Installation\n\nCopy zfs folder to cockpit\n\n```bash\n$ git clone https://github.com/optimans/cockpit-zfs-manager.git\n$ sudo cp -r cockpit-zfs-manager/zfs /usr/share/cockpit\n```\n\n#### Samba\n\nAuto generated snapshot names are created in YYYY.MM.DD-HH.MM.SS format.\n\nIt is recommended to add the following properties to the Samba configuration file to allow access to Previous Versions in Windows Explorer:\n\n```bash\n$ sudo nano /etc/samba/smb.conf\n```\n\nAppend to [global] section or individual share sections\n\n```\nshadow: snapdir = .zfs/snapshot\nshadow: sort = desc\nshadow: format = %Y.%m.%d-%H.%M.%S\nshadow: localtime = yes\t\nvfs objects = acl_xattr shadow_copy2\n```\n\n#### SELinux\n\nIf using SELinux in enforcing mode, it is recommended to enable the boolean states for Samba:\n\n```bash\n$ sudo setsebool -P samba_export_all_ro=1 samba_export_all_rw=1\n```\n\n## Using Cockpit ZFS Manager\n\nLogin to Cockpit as an administrative user and click ZFS from the navigation list.\n\nA Welcome to Cockpit ZFS Manager modal will display and allow you to configure initial settings.\n\n## Caveats\n\n#### Storage Pools\n\nNew storage pools are created with the following properties set (not visible in Create Storage Pool modal):\n\n * aclinherit=passthrough\n * acltype=posixacl\n * casesensitivity=sensitive\n * normalization=formD\n * sharenfs=off\n * sharesmb=off\n * utf8only=on\n * xattr=sa\n\n#### File Systems\n\nNew file systems are created with the following properties set (not visible in Create File System modal):\n\n * normalization=formD\n * utf8only=on\n\nPassphrase is currently supported for encrypted file systems.\n\nIf SELinux contexts for Samba is selected, the following properties are set:\n\n * context=system_u:object_r:samba_share_t:s0\n * fscontext=system_u:object_r:samba_share_t:s0\n * defcontext=system_u:object_r:samba_share_t:s0\n * rootcontext=system_u:object_r:samba_share_t:s0\n\n#### Samba\n\nZFS always creates shares in /var/lib/samba/usershares folder when ShareSMB property is enabled. This is also the case even if Cockpit ZFS Manager is managing the shares. To avoid duplicate shares of the same file system, it is recommended to configure a different usershares folder path if required or to disable usershares in the Samba configuration file.\n\nNote: Newer versions of Samba may require the usershares folder to be set to a new path instead of disabled in configuration:\n\n```bash\n$ sudo mkdir /var/lib/samba/usershares2\n$ sudo nano /etc/samba/smb.conf\n```\n\nAppend/Change to [global] section\n\n```\nusershare path = /var/lib/samba/usershares2\n```\n\nIf enabled, Cockpit ZFS Manager manages shares for the file systems only. Samba global configuration will need to be configured externally.\n\n## Guides\n\n * [Red Hat Enterprise Linux 8 as an Active Directory Domain Services (AD DS) Member](guides/Red-Hat-Enterprise-Linux-8.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foptimans%2Fcockpit-zfs-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foptimans%2Fcockpit-zfs-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foptimans%2Fcockpit-zfs-manager/lists"}