Files
oam/knowledge base/openmediavault.md
2023-09-15 00:51:49 +02:00

3.9 KiB

OpenMediaVault

NAS solution based on Debian Linux.

Table of contents

  1. TL;DR
  2. Make other users administrators
  3. Remove access for the default admin user
  4. OMV-Extras
  5. ZFS
    1. ZFS plugin
  6. Further readings
  7. Sources

TL;DR

# Make other users administrators.
gpasswd -a 'me' 'openmediavault-admin'
usermod -aG 'openmediavault-admin' 'me'

# Revoke WebUI access from the 'admin' user.
gpasswd -d 'admin' 'openmediavault-admin'
deluser 'admin' 'openmediavault-admin'

# Install plugins from the CLI.
apt install 'openmediavault-clamav'

# Install OMV-Extras.
wget -O - 'https://github.com/OpenMediaVault-Plugin-Developers/packages/raw/master/install' | bash

# Disable the kernel's backports sources.
mv -v \
  '/etc/apt/sources.list.d/openmediavault-kernel-backports.list' \
  '/etc/apt/sources.list.d/openmediavault-kernel-backports.list.disabled'

Make other users administrators

Just add the user to the openmediavault-admin group:

gpasswd -a 'me' 'openmediavault-admin'
usermod -aG 'openmediavault-admin' 'me'

Remove access for the default admin user

Only do this after you created another user and made it an admin.

From the safest to the less safe option:

  1. Lock the account:
    chage -E0 'admin'
    
  2. Remove it from the openmediavault-admin group:
    gpasswd -d 'admin' 'openmediavault-admin'
    deluser 'admin' 'openmediavault-admin'
    
  3. Delete it completely:
    userdel -r 'admin'
    deluser 'admin'
    

OMV-Extras

From the CLI, as the root user:

  1. Install OMV-Extras:

    wget -O - \
      'https://github.com/OpenMediaVault-Plugin-Developers/packages/raw/master/install' \
    | bash
    

ZFS

ZFS plugin

  1. [Install OMV-Extras].

  2. Pick one:

    • Disable the kernel's backports APT sources and stick to the mainline one.
      Linux backport kernels are released quickly enough to leave the userland incomplete at times. This often happens with ZFS, resulting in broken package issues.

      mv -v \
        '/etc/apt/sources.list.d/openmediavault-kernel-backports.list' \
        '/etc/apt/sources.list.d/openmediavault-kernel-backports.list.disabled'
      
    • Install the openmediavault-kernel plugin and use it to install the Proxmox kernel.
      Debian does not build ZFS kernel modules into any of their kernels by default due to licensing conflicts. This may result in an extensive build process during installation, which is prone to errors.

      The Proxmox-Debian kernel has the ZFS kernel modules preinstalled by default. As kernel upgrades become available and are performed, the userland for the Proxmox kernel will always have the required packages to support ZFS.

  3. Install the openmediavault-zfs plugin.

  4. Create pools and such.
    You might need to wipe the disks first.

Further readings

Sources

All the references in the further readings section, plus the following: