From openmediavault
Jump to: navigation, search


Frequently Asked Questions

What is OMV?

OMV is an abbreviation of OpenMediaVault

Is OpenMediaVault a fork of FreeNAS?


Does OpenMediaVault have drivers for my hardware?

All module drivers are provided by the Debian standard kernel of oldstable release 7.9 (aka Wheezy). This distribution ships with kernel 3.2 by default. You can optionally install the backport kernel 3.16. If your hardware is supported under Debian Wheezy then is supported under OMV.

The Wheezy backport kernel 3.16 is the default kernel used by Jessie (Debian 8.2) at the moment, so it provides support for newer hardware. See here for a list of hardware that is not recognized by the default installer but it is supported under BPO Kernel 3.16

Can I use a usb flash drive (stick) for installing the system?

Yes, but the installation does not have any optimizations to reduce writes into the OS disk. Your usb media will most likely start failing within a few weeks of usage. Most common symptom is basic command execution does not work, denied login, etc.

What is the file /etc/openmediavault/config.xml for?

Is the base configuration store file for OpenMediaVault. When a change is performed in the webUI, the config value is stored and/or retrieve by rpc, if this is a save change, then mkconf passes the value to the service configuration file and reloads the daemon in case is necessary.

Can I upgrade to Debian Testing/Unstable (Debian Testing/Sid) or use Ubuntu as a base distribution?

No. You can't.

I´ve lost the WebInterface password. How do I reset it?

Simply connect via ssh to your server or login locally on your machine and type in: omv-firstaid . There is an option to reset your password. More information about omv-firstaid

Is the server central configuration file. All options are stored there for the webUI to read and store values.

Can I backup or restore and existing OpenMediaVaut configuration?

No. You can keep the file /etc/openmediavault/config.xml for references purposes if you decide to go for a clean re-install

What is the default HTTP engine of OpenMediaVault?

NGINX. The last version of OMV with Apache was 0.5 Sardoukar.

Can I use Apache as HTTP engine?

You can use it but is not supported. Eventually every openmediavault package upgrade will activate NGINX again leaving you with a broken webUI. You can run a parallel Apache instance to Nginx just make sure the ports are different otherwise your OMV webUI will not work.

How can use the default http engine to hold my own web page?

Do not modify OpenMediaVault default nginx files. Read Nginx [[1]]. You can place your website configurations at /etc/nginx/sites-{available,enabled}.

Why does the system rewrites a configuration file(s) that I have manually edited?

OMV takes full control of some system services. This services include monit, ntp, samba, network, proftpd, nginx, php5-fpm, etc add more

How can I modify an internal value of some service OpenMediaVault has control of?

Read here for advanced configurations

How can I modify or add a network configuration of /etc/network/interfaces with some custom options the webUI does not provide?

The interfaces file is controlled by OpenMediaVault. To add network interfaces that are not configurable through the webGUI or other options not present, you need to use an advanced configuration

Why my disks mount paths have a long alphanumeric number?

The long number is called UUID, it is used by fstab to mount disks. This number is unique per filesystem (or at least unlikely possible that another disk comes with an identical one). This helps maintaing the mount points. If we used the old linux way (sda1, sdb1, etc) is not guaranteed that /sda1 is the same disk on next reboot. If you have trouble identiying them in terminal, you can always create a pool with symlinks to each file system with easy to remember names.

I don't have a data disk, and I want to use my OS disk for storing data?

The default behaviour of OpenMediaVault is to act as NAS server, that means OS files are separated from data disks. You can use partitions in the same disk you use for OS and the system will recognise the partitions for formatting, mounting and to create shared folders. The current installer does not provide access to the partition manager, so you need to use a standard Debian installer then install OpenMediaVault on top or resize the partition after installing using Gparted or SystemRescueCd.

Can I install OpenMediaVault on top a running Debian system?

Yes, but is not recommended that the running OS has a desktop environment installed. Read [[2]] how to install on top of a running Debian Wheezy install.

Which are the files that should not be edited by the user?

There are several services that OpenMediaVault takes control of, The recommended list is here

What is the permissions/ownership of folders in OMV created by shared folders?

The default is folders in 2775 mode, with root:users ownership. This means all users created in the webUI can read, write to folders created by the system in the data drives using the default.

Why are my filesystems mounted as noexec?

This is a security measure to avoid the placement of malicious scripts in the shared folders. This will prevent any script execution in those paths, including compiling packages and binaries. If you need to remove the noexc flag, you need to use environmental variables

I need to delete a shared folder, why the delete button is greyed/disabled?

Shared folder configurations can be used across different services. If you need to remove a shared folder configuration you need to unlink it from every service is attached to it before the delete button becomes available. At the moment there is no internal database backend that can display information about which service is holding which shares.

What is the omv-mkconf command for?

omv-mkconf is a terminal console command that is used by the backend of OMV to pipe directives and values to service configuration files. The arguments that omv-mkconf accepts are related to the name of the service it configures. Type omv-mkconf in terminal, press TAB key, and the terminal will display all available arguments.

I want to experiment with OpenMediaVault or make changes to the code

As a true open source system you can do whatever you want with it. The recommendation is you don't do it in your home appliance server to avoid breaking the web interface. The best thing to do is to use a Virtual Machine. In [[3]] you can find a preconfigured OpenMediaVault virtual disk ready to launch.

What is the omv-update and omv-release-upgrade do?

Information about those commands are in the upgrade section