User Tools

Site Tools

This guide assumes you are starting from scratch, with a brand new Ubuntu 18.04 - 24.04 (any distribution, including Minimal/Netboot) installation, and need a new Serviio install.

This installation is based on 18.04.2 LTS, Minimal Edition, 20.04 Netboot, Xubuntu 22.04, and Ubuntu Server 24.04 Normal Installation (but this should work for any version of Ubuntu 18.04 - 24.04 or any desktop variant). At the time of the updating this document (June 18, 2024), the newest version of Serviio is 2.4.

Please read the entire procedure before installation so you are familiar with the process before “taking on the terminal”.

Previous versions were tested using an Intel i5-4th Generation computer with 16GB of RAM. Ubuntu 24.04 and Serviio 2.4 were tested using an i5-10th generation with 16GB of RAM

Since the Minimal install also doesn’t contain the packages of its big brothers, this will give you the information you need to install all the packages required to run Serviio from a minimal Ubuntu Server installation. The process is the same on the other Ubuntu variants, but some of the software packages will be pre-installed.

If you have a desktop variant, all you should have to do is to copy and paste the text in the boxes into a terminal.

1. Download and Install Ubuntu 18.04 - 24.04 (Any variant will work with this guide: Ubuntu Desktop, Minimal, Netboot, Server, Lubuntu, Kubuntu, Mint, Bodhi, etc.).

2. Open a Terminal window. Make sure you have all the updates by running the following two commands at least once:

sudo apt update
sudo apt upgrade

3. Enable root.

You will need it later as an active account. Pass the following command to enable root login:

sudo passwd

It will ask for your user password, followed by the new submission for the password for root, and a confirmation of that password. Make sure this is an extremely complex password, as a person can do a great amount of damage to a system by logging in as root.

4. Install a few things. (Some of these will already be installed if you have a desktop variant, of which Ubuntu will notify you and then install the rest, but all are recommended if you installed Ubuntu Netboot or Server.) Run the following commands:

sudo apt update
sudo apt install net-tools software-properties-common openjdk-11-jre default-jre ffmpeg dcraw wget

It will take a while to download and install. The command will install a package for network metrics, the software to bind file types, executables, and repositories, the Java Runtime Environment, the video transcoder, picture decoder/thumbnailer, and file downloader, as well as all their dependencies.

5. Installing Serviio.

a. Change to the directory where you will be installing Serviio.

cd /opt

b. Download the Serviio software.

sudo wget

c. Extract the software.

sudo tar zxvf serviio-2.4-linux.tar.gz

d. Create a soft link to the Serviio directory.

sudo ln -s serviio-2.4 serviio

e. Have the root user on your computer take ownership of the Serviio files.

sudo chown -R root:root /opt

f. Remove the installation file.

sudo rm serviio-2.4-linux.tar.gz

g. Next, we need to create a service to make sure Serviio starts when the machine reboots. Enter the following command to create a file named serviio.service in the system service directory:

sudo nano /lib/systemd/system/serviio.service

h. Put in the following information:

Description=Serviio Media Server

ExecStop=/opt/serviio/bin/ -stop


Hit ctrl+o to save the file and ctrl+x to exit the editor.

i. Enable the Serviio Service with the following commands, executed in order:

sudo systemctl daemon-reload
sudo systemctl enable serviio.service
sudo systemctl start serviio.service

After running the enable command, it should tell you that the OS added the service to the multi-user target. You can now test to see if the console is available using the URL below.

j. Run the “sudo reboot” command to reboot and make sure the Serviio service starts correctly after rebooting.

sudo reboot

Congratulations! Serviio is installed.

Next, you need to start setting it up from the console using:


If you are having issues, The F.A.Q. is located here:
Serviio Support

And, the support forums are located here:
Serviio Forum

howto/linux/install/ubuntu18-04.txt · Last modified: 2024/06/19 02:53 by cmakula