====== Ubuntu Server Installation Guide ======
Based on [[http://www.bigfatostrich.com/2011/08/serviio-media-center-on-debian/|bigfatostrich's Howto]] and Forum members contributions

----
==== Prerequisites ====
  * Java
    You need Java version 8 or later.  To find out what version you have type:<code>java -version</code>
Confusingly you are looking for a version of 1.8 or later.  If you don't have this then you will need to install it.  There are more ways of installing Java on your system than I want to articulate here, but if you just want Serviio to work then the following is a good solution:<code>sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java8-installer</code>
  * FFmpeg
<code>sudo apt-get install ffmpeg libavcodec-extra-53 libavformat-extra-53</code>
<note tip>FFmpeg is [[https://askubuntu.com/questions/432542/is-ffmpeg-missing-from-the-official-repositories-in-14-04|replaced]] by avconv</note>
  * workaround for missing FFmpeg
<code>sudo add-apt-repository ppa:mc3man/trusty-media</code>
<code>sudo apt-get update</code>
<code>sudo apt-get install ffmpeg gstreamer0.10-ffmpeg</code>
  * dcraw for digital pictures
<code>sudo apt-get install dcraw</code>
==== 1.Download Serviio ====
Always check what the latest version is on the website, it is currently 1.6.1 and update accordingly
Here is link to serviio.org download page.
http://www.serviio.org/download
<code>wget http://download.serviio.org/releases/serviio-1.6.1-linux.tar.gz</code>
==== 2.Extract Serviio ====
<code>tar xvf serviio-1.6.1-linux.tar.gz
</code>
==== 3.Ubuntu Server Startup Script (credit to forum member jonolafur) ====

Note for Ubuntu systems that use systemd not upstart (i.e. 15+) this forum item discusses the way to configure correctly: [[http://forum.serviio.org/viewtopic.php?f=5&t=4836]]

Create and save the following script in the directory /etc/init/ and call it serviio.conf
<code>start on started networking
script
   /<path-to-serviio>/serviio.sh
end script</code>

and replace <path-to-serviio> with the actual path to your serviio installation.

If any problems should arise with the system locales, a specific locale can be added to the script right before the path to serviio.

<code>start on started networking
script
   LANG=da_DK.utf8 /<path-to-serviio>/serviio.sh
end script</code>

The system specific locale can be found using the following command.

<code>locale -a</code>This should yeild a list like this.
<code>$ locale -a
C
C.UTF-8
da_DK.utf8
en_AG
en_AG.utf8
en_AU.utf8
en_BW.utf8
en_CA.utf8
en_DK.utf8
en_GB.utf8
en_HK.utf8
en_IE.utf8
</code>
Replace "LANG=da_DK.UTF8" in the script with the desired locale.

The upstart system now starts the serviio server as soon as all networking jobs have been started:

<code>sudo /etc/init.d/networking restart</code>

If you need it to start earlier or later, please check the excellent documentation on upstart for example here:

[[http://upstart.ubuntu.com/cookbook/|Upstart Cookbook]]

You can now get a list of all jobs registered with upstart by issuing:

<code>initctl list</code>

and you should get something like:

<code>serviio start/running, process 1009</code>

if it is already running, otherwise it says:

<code>serviio stop/waiting</code>

You can start and stop the job via:

<code>sudo start serviio</code>

and

<code>sudo stop serviio</code>

==== Fixing multicast on Linux hosts ====
On Linux hosts it could be that you need to set up [[http://forum.serviio.org/viewtopic.php?f=5&t=415&p=2843#p2837|multicast]] to let Serviio work correctly
To do this, add following line to /etc/network/interfaces:
<note important>Replace eth0 with the [[http://www.cyberciti.biz/faq/linux-list-network-interfaces-names-command/|name of the network interface]]</note>
<code>up route add -net 239.0.0.0 netmask 255.0.0.0 dev eth0</code>


==== Making Serviio's MediaBrowser accessible via the web ====
<note>Instructions given are tested on an Ubuntu Server running Apache 2.4</note>
Usually you go to http://localhost:23424/mediabrowser to access the MediaBrowser. It is possible to make something like http://www.your-example-domain.com/media. This is done with Apache's ProxyPass.

Enable proxy module
<code>a2enmod proxy</code>

Make a new Apache configuration file
<code>nano /etc/apache2/sites-enabled/001-serviio.conf</code>

Put this inside
<code><Location /media>
Require all granted
ProxyPass http://localhost:23424/mediabrowser
ProxyPassReverse http://localhost:23424/mediabrowser
</Location>

<Location /cds>
Require all granted
ProxyPass http://localhost:23424/cds
ProxyPassReverse http://localhost:23424/cds
</Location></code>

Enable the new configuration and reload your configuration
<code>
a2ensite 001-serviio
service apache reload
</code>

==== Setting up a password ====
Go to <ip-address of the server>:23423/console/ and use this console to set up a password.

~~NOTOC~~