MinimServer

Home

Donate

Features

Downloads

Installing

Release notes

User guide

Support

Troubleshooting

Forum

MinimStreamer

License

UPnP AV

Technology

Contact

Latest news

Added support for digital booklets

Latest change

MinimServer update 97 has been released

Installing MinimServer on Linux

Installing Java on Linux
Installing MinimServer on Linux
Updating MinimServer on Linux
Uninstalling MinimServer on Linux
Running MinimServer on Linux
Installing MinimWatch to manage MinimServer

Note 1: If you have a Raspberry Pi running Raspbian, please refer to this page for instructions on how to install Java and MinimServer.

Note 2: If you have a Synology NAS, please refer to this page for instructions on how to install Java and MinimServer.

Note 3: If you have a QNAP NAS, please refer to this page for instructions on how to install Java and MinimServer.

Note 4: If you have a NETGEAR ReadyNAS, please refer to this page for instructions on how to install Java and MinimServer.

Installing Java on Linux

MinimServer is written in Java and requires Java 7 or later to be installed. If you don't already have this installed and you're running Linux x86 or Linux x64 as a desktop system, you can download the current version of the Oracle Java Runtime Environment (JRE) from this page and follow the installation instructions there. If you're running Linux on an ARMv6 or ARMv7 machine, you can download Oracle JDK 7 for ARM from this page or you can download Oracle JDK 8 for ARM from this page.

If you want to run MinimServer in an embedded Linux environment such as a plug computer or NAS, you can download the current version of Oracle Java SE Embedded from this page. You can download either Java SE Embedded 7 or Java SE Embedded 8. Review and accept the Oracle license agreement, then click on the download link for the correct .tar.gz file for your machine architecture. You'll be prompted to create or login to your Oracle account before you can download the file.

After downloading the Java SE Embedded .tar.gz file, use tar xf to unpack its contents to a local directory. After doing this, create a link to the java executable from a location on the path. The usual location for this link is the /usr/local/bin directory. For example, if you have unpacked the .tar.gz download for Java 7 update 45 into the directory /usr/local/ejre, you can create this link by using the following command:
 ln -s /usr/local/ejre/ejre1.7.0_45/bin/java /usr/local/bin

If you're using Debian or Ubuntu, another option is to use apt-get to download and install the openjdk-7-jre or openjdk-7-jre-headless package. The former package is used for desktop systems with a graphical user interface and the latter package is used for embedded systems without a graphical user interface. On ARM systems, runtime performance of the current OpenJDK download is considerably worse than Oracle JDK and Oracle Java SE Embedded. On x86 and x64 systems, there's no significant difference.

After installing Java, use the command
 java -version
to make sure Java is installed correctly and is available on the path. This is important for correct operation of the MinimServer command scripts.

Installing MinimServer on Linux

If you have a previous version of MinimServer already installed, see the section Updating MinimServer on Linux for details of how to update your installation to a new version.

For a new installation of MinimServer on Linux, do the following:

  1. You can install MinimServer in your home directory or in another directory. If you're installing MinimServer in another directory, create this directory using mkdir. In the following instructions, we'll refer to this directory as the <minim-home> directory.
  2. Download the archive file MinimServer-0.8.4-linux-x86.tar.gz, MinimServer-0.8.4-linux-x64.tar.gz, MinimServer-0.8.4-linux-arm.tar.gz, MinimServer-0.8.4-linux-armhf.tar.gz or MinimServer-0.8.4-linux-ppc.tar.gz (depending on which version of Linux you're running) from the Downloads page and save this file in the <minim-home> directory.

    Note: The x64 version of MinimServer must be launched using 64-bit Java, and the x86 version of MinimServer must be launched using 32-bit Java. If you use 32-bit Java to launch the x64 version of MinimServer (or vice versa), you'll get an error message.

  3. Use tar xf to unpack the downloaded archive file into the <minim-home> directory. For example, on Linux x86, you would use the following commands in a terminal window:
     cd <minim-home>
     tar xf MinimServer-0.8.4-linux-x86.tar.gz
  4. Enter the command:
     minimserver/bin/setup
    The setup command will ask whether you want to enable desktop integration (if available) and/or automatic startup (if available). If you enable desktop integration, a MinimServer launch icon will appear on your desktop. If you enable automatic startup, MinimServer will be started automatically when the computer is started or rebooted.
  5. If you're running in a graphical desktop environment, double-click the MinimServer launch icon on your desktop. Alternatively, if you're running in a "headless" environment, open a terminal window and run the command
     minimserver/bin/startc
  6. If this is the first time you've started MinimServer, MinimServer will prompt you for your content directory. This is the directory that contains your music files. If you're running in a graphical desktop environment, MinimServer will show a file chooser dialog on the desktop and ask you to select a content directory. Alternatively, if you're running in a "headless" environment, MinimServer will run as a terminal application and will display a command prompt asking for the name of the content directory, which you need to enter as a full Linux-style path. If you need to add additional content directories, you can do this later.
  7. MinimServer will scan all the music files under the content directory that you configured during the installation process. Depending on how many music files you have, this might take some time. If you're running in a graphical desktop environment, MinimServer will display a yellow icon with a minim symbol (musical note) in the system tray or menu bar while this scan is in progress. When the scan has finished successfully, the colour of the minim icon will change to green. If MinimServer startup fails for any reason, the colour of the minim icon will change to red and you'll see a pop-up message describing the problem. Alternatively, if you're running in a "headless" environment, a terminal message will be displayed either indicating successful startup or describing a startup problem.
  8. It's a good idea to check the MinimServer log to see if there are any warning or error messages about problems found by MinimServer while scanning your music files. If you're running in a graphical desktop environment, right-click on the minim icon and select "Show log". Alternatively, if you're running in a "headless" environment, you can see the log output in the file <minim-home>/minimserver/data/minimserver.log or you can use MinimWatch on another computer to check the log. A warning in the log means that MinimServer has found something wrong with a file, but has been able to read the file and make it available for browsing and playing. An error in the log means that MinimServer wasn't able to read the file. If you see a message you don't understand, you can get help by creating a new thread in the MinimServer support forum as described on the Support page.
  9. If MinimServer has started successfully, you can use a UPnP control point to browse your music library and select and play music.
  10. If you can't see MinimServer from a UPnP control point or if you're having problems trying to play music, check that you don't have a firewall blocking the following ports: udp/1900, tcp/9790, tcp/9791.
  11. If you're running in a graphical desktop environment, MinimServer installation is now complete. The minim icon pop-up menu provides a number of selections that you can use to configure and manage MinimServer. For information about these menu selections, see the Controlling MinimServer using the minim icon section of the User guide.
  12. If you're running in a "headless" environment, MinimServer will terminate if the terminal window is closed for any reason. To prevent this happening, press Enter at the command prompt to exit MinimServer, then enter the command:
     minimserver/bin/startd
    This restarts MinimServer as a daemon background process that will continue to run after the terminal window is closed.
  13. To configure and manage MinimServer when it's running as a daemon background process, you need to install MinimWatch either on this computer or on another computer that's connected to your local network. For details of how to do this, see the section Installing MinimWatch to manage MinimServer.
  14. To change your current settings for desktop integration and/or automatic startup, you can run the minimserver/bin/setup command at any time. This command lists your current settings and prompts you to change them. As an alternative to changing settings using interactive prompts, you can specify a single argument to the minimserver/bin/setup command as follows:
     minimserver/bin/setup enable_desktop enables desktop integration
     minimserver/bin/setup disable_desktop disables desktop integration
     minimserver/bin/setup enable_autostart enables automatic startup
     minimserver/bin/setup disable_autostart disables automatic startup
  15. You can run an additional instance of MinimServer on the same Linux sytem by installing another copy of MinimServer using a different <minim-home> directory. To prevent conflicts between these instances, you should change the values for http.port, ohnet.port and displayName in the first instance before you install the second instance. If you enable both instances for automatic startup using minimserver/bin/setup, both instances will be started when you boot the system. The instances are completely independent and don't share any configuration settings. Don't attempt to copy the configuration file from one instance to the other because this will cause problems. Both instances can point to the same music library if you wish. Any updates and new releases must be applied separately to both instances. There is no limit to the number of instances you can create in this way.

Updating MinimServer on Linux

To update an existing installation of MinimServer (0.8.1 or later), do the following:

  1. Download the archive file MinimServer-0.8.4-linux-x86.tar.gz, MinimServer-0.8.4-linux-x64.tar.gz, MinimServer-0.8.4-linux-arm.tar.gz, MinimServer-0.8.4-linux-armhf.tar.gz or MinimServer-0.8.4-linux-ppc.tar.gz (depending on which version of Linux you're running) from the Downloads page and save this file in the <minim-home> directory.
  2. Enter the command:
     <minim-home>/minimserver/bin/update <archive-name>
    where <archive-name> is the name of the archive file that you downloaded.
  3. This stops any MinimServer instances that are currently running, uninstalls the current version of MinimServer, installs the new version of MinimServer, and migrates your current MinimServer configuration file to the new version of MinimServer.
  4. To start the new version of MinimServer, follow the instructions in the Running MinimServer on Linux section.

To update an existing installation of MinimServer (0.72 or earlier), make sure that MinimServer isn't running, then follow the instructions for doing a new MinimServer installation into a new <minim-home> directory. After unpacking the downloaded archive, copy your existing minimserver.config file into the <minim-home>/minimserver/data directory to migrate your current configuration settings to the new installation.

Uninstalling MinimServer on Linux

To uninstall MinimServer on Linux, do the following:

  1. Enter the command:
     <minim-home>/minimserver/bin/uninstall
    This stops any MinimServer instances that are currently running and uninstalls MinimServer.
  2. You'll be asked whether you want to save your MinimServer configuration file. It's a good idea to save your configuration file if there's any chance that you might reinstall MinimServer in the future. If you reinstall MinimServer in the same <minim-home> directory and run the minimserver/bin/setup command, your saved configuration file will be restored.

Running MinimServer on Linux

To start MinimServer in a graphical desktop environment, double-click the MinimServer launch icon on your desktop. The minim icon will appear in the desktop system tray or menu bar and you can use the minim icon pop-up menu to configure and manage MinimServer. See the Controlling MinimServer using the minim icon section for details of the available menu selections. You can stop this instance of MinimServer by using the minim icon pop-up menu Exit selection or by using the minim icon pop-up menu Close selection from a remote instance of MinimWatch.

To start MinimServer as a daemon background process, use the command:
 <minim-home>/minimserver/bin/startd
You can configure and manage the MinimServer daemon process by using MinimWatch. See the Running MinimWatch section for details.

To start MinimServer as an interactive console application in the current terminal window, use the command:
 <minim-home>/minimserver/bin/startc
You can configure and manage MinimServer by entering commands from the terminal window. See the Controlling MinimServer using console commands section for details of the available commands. You can stop this instance of MinimServer by using the exit command or by pressing Enter at the command prompt. This instance of MinimServer will also be stopped if its terminal window is closed.

[DEPRECATED] On version 0.8.3 or earlier, you can send commands to MinimServer via a local named pipe. This capability is now replaced by the new command scripting feature in version 0.8.4 (see the Command scripting section) and the named pipe facility will be removed completely in the next version of MinimServer.

To stop all instances of MinimServer (started in any of the above ways), use the command:
 <minim-home>/minimserver/bin/stopall
This stops all MinimServer processes that are running on this computer.

Installing MinimWatch to manage MinimServer

If you're running in a "headless" environment, or if you want to be able to configure and manage MinimServer from another computer, you can install and run MinimWatch either on this computer or on another computer that's connected to your local network. The computer that you use to run MinimWatch can be running Windows, Mac OS X or Linux.

For details of how to install and uninstall MinimWatch on a Windows PC, see the Installing MinimWatch on Windows page. If you're installing MinimWatch on Mac OS X, see the Installing MinimWatch on Mac OS X page. If you're using Linux to run MinimWatch, see the Installing MinimWatch on Linux page.