This shows you the differences between two versions of the page.
Both sides previous revision Previous revision | |||
howto:linux:install:debian [2013/07/11 07:01] i-matrixx [1. Install missing codecs] |
howto:linux:install:debian [2017/11/26 21:38] (current) stanislav.belichenko A long time ago in a galaxy far, far away... somebody wrote this page |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Debian Installation Guide ====== | + | <note important>This guide assumes you have installed Debian 8 (Jessie) and need a new Serviio install.</note> |
- | ===== Prerequisites ===== | + | <note warning>The new Serviio 1.9 requires Java 8. The old Serviio 1.4 required Java 7</note> |
- | To ensure flawless operation of Serviio, additional codecs and libraries must be installed not available in current Debian distribution. The packages containing the additional codecs and libraries can be installed from [[http://deb-multimedia.org]]. | + | |
- | For instructions how to install packages from [[http://deb-multimedia.org]] follow the the next steps. | + | Update: If you are interested in installing the newest version than go to http://serviio.org/download to see which is the newest version at the time. As of Nov 27, 2017 the newest version is Serviio 1.9 |
- | ==== 1. Install missing codecs ==== | + | Debian 8 (Jessie) adds back ffmpeg, so there is no need for an extra PPA. Install required software if not already installed: |
+ | <code>sudo apt-get install ffmpeg | ||
+ | sudo apt-get install dcraw | ||
+ | </code> | ||
- | === 1.1 Preparation === | + | Install Java 8. You can tell which, if any, versions are installed via: |
+ | <code>dpkg --get-selections | grep jre | ||
+ | </code> | ||
- | == 1.1.1 Install codecs from deb-multimedia.org == | + | You may see openjdk-7-jre. If you see both openjdk-7-jre and openjdk-8-jre, check which is the default version via: |
+ | <code>java -version | ||
+ | </code> | ||
- | **Beware** that Debian has decided to switch to libav [[http://www.libav.org]]. If you decide to use ffmpeg from deb-multimedia.org you can no longer use libav and programs relying on it. | + | If openjdk-8-jre is installed and "java -version" yields "1.9.0_xx", you are done. If Java is not installed or only Java 7, run: |
+ | <code>sudo apt-get install openjdk-8-jre | ||
+ | </code> | ||
- | Create a file /etc/apt/sources.list.d/deb-multimedia.list and add one of the following lines according to your distribution: | + | If you get an error like this: |
+ | <code> | ||
+ | The following packages have unmet dependencies: | ||
+ | openjdk-8-jre-headless : Depends: ca-certificates-java but it is not going to be installed | ||
+ | E: Unable to correct problems, you have held broken packages. | ||
+ | </code> | ||
- | **testing** | + | do not despair, this command will help you: |
- | <code>deb http://www.deb-multimedia.org testing main non-free</code> | + | <code> |
- | or | + | apt install -t jessie-backports openjdk-8-jre-headless ca-certificates-java |
- | <code>deb ftp://ftp.deb-multimedia.org testing main non-free</code> | + | </code> |
- | **unstable** | + | |
- | <code>deb http://www.deb-multimedia.org unstable main non-free</code> | + | |
- | or | + | |
- | <code>deb ftp://ftp.deb-multimedia.org unstable main non-free</code> | + | |
- | Next update your list of packages | + | After that, try run the previous command again. |
- | <code>apt-get update</code> | + | If both Java 7 and 8 are installed, you may have to adjust the default via update-java-alternatives or edit scripts to specify the full path, e.g., /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java. |
- | and in first place install the deb-multimedia-keyring | + | There are various ways to install Serviio, but this installs it in /opt and runs it as user serviio. The useradd option -r creates a system account and does not create a home directory. This will result in warnings in serviio.log, but there seems to be no ill effect. The first line logs in as root to make a few things easier: |
+ | <code>sudo -H bash | ||
+ | useradd -r -s /bin/false serviio | ||
+ | mkdir -p /opt | ||
+ | cd /opt | ||
+ | wget http://download.serviio.org/releases/serviio-1.9-linux.tar.gz | ||
+ | tar zxvf serviio-1.9-linux.tar.gz | ||
+ | rm serviio-1.9-linux.tar.gz | ||
+ | ln -s serviio-1.9 serviio | ||
+ | chown -R root:root serviio-1.9 | ||
+ | cd serviio-1.9 | ||
+ | mkdir log | ||
+ | chown -R serviio:serviio library log | ||
+ | </code> | ||
- | <code>apt-get install deb-multimedia-keyring</code> | + | Use your favorite text editor and create /lib/systemd/system/serviio.service with: |
+ | <code> | ||
+ | [Unit] | ||
+ | Description=Serviio Media Server | ||
+ | After=syslog.target local-fs.target network.target | ||
- | == 1.1.2 Install static compiled ffmpeg binary == | + | [Service] |
+ | Type=simple | ||
+ | User=serviio | ||
+ | Group=serviio | ||
+ | ExecStart=/opt/serviio/bin/serviio.sh | ||
+ | ExecStop=/opt/serviio/bin/serviio.sh -stop | ||
+ | KillMode=none | ||
+ | Restart=on-abort | ||
- | This is a static compiled version of ffmpeg so there is no need to replace an mess up your system with a whole bunch of libraries from deb-multimedia.org. | + | [Install] |
+ | WantedBy=multi-user.target | ||
+ | </code> | ||
- | Q: What does static mean? | + | Lastly, start serviio and have it run automatically at boot via: |
- | A: This is a single fat binary which has no external dependencies to any libraries. There is no need to install anything except one package. | + | <code> |
+ | systemctl daemon-reload | ||
+ | systemctl enable serviio | ||
+ | systemctl start serviio | ||
+ | </code> | ||
- | Create or modify the file /etc/apt/sources.list.d/debian.i-matrixx.list and add the following line | + | Now, launch the configuration console by typing the following into the Terminal |
+ | <code> | ||
+ | sudo /opt/serviio-1.9/bin/serviio-console.sh | ||
+ | </code> | ||
- | <code>deb http://debian.i-matrixx.de ffmpeg-serviio main</code> | ||
- | and add the APT key with the following command | ||
- | |||
- | <code>wget -O - http://debian.i-matrixx.de/52CE883E.asc | sudo apt-key add -</code> | ||
- | |||
- | Next update your list of packages | ||
- | |||
- | <code>apt-get update</code> | ||
- | |||
- | and install the ffmpeg-serviio package. | ||
- | |||
- | |||
- | == 1.2 Install ffmpeg == | ||
- | <code>sudo apt-get install ffmpeg</code> | ||
- | |||
- | |||
- | === 2. Install Serviio === | ||
- | |||
- | == 2.1 Download Serviio Debian package == | ||
- | |||
- | Installation of binary packages from unknown sources is strongly discouraged. | ||
- | But for the lazy ones here are the steps to get everything up und running. | ||
- | |||
- | Create or modify the file /etc/apt/sources.list.d/debian.i-matrixx.list and add the following line | ||
- | |||
- | <code>deb http://debian.i-matrixx.de serviio main</code> | ||
- | |||
- | and add the APT key with the following command | ||
- | |||
- | <code>wget -O - http://debian.i-matrixx.de/52CE883E.asc | sudo apt-key add -</code> | ||
- | |||
- | Next update your list of packages | ||
- | |||
- | <code>apt-get update</code> | ||
- | |||
- | and install the serviio package | ||
- | |||
- | <code>apt-get install serviio</code> | ||
- | |||
- | For further assistance or questions regarding this package write to debian [@] i-matrixx [dot] de. | ||
- | |||
- | == 2.2 Download source package and build package yourself (recommended) == | ||
- | |||
- | This is the recommended way to install the Debian serviio package and ensures you can verify the changes the author has made. | ||
- | |||
- | Create or modify the file /etc/apt/sources.list.d/debian.i-matrixx.list and the following line | ||
- | |||
- | <code>deb-src http://debian.i-matrixx.de serviio main</code> | ||
- | |||
- | and add the APT key with the following command | ||
- | |||
- | <code>wget -O - http://debian.i-matrixx.de/52CE883E.asc | sudo apt-key add -</code> | ||
- | |||
- | Next update your list of packages | ||
- | |||
- | <code>apt-get update</code> | ||
- | |||
- | To download and build a source package, you would use the following command as root: | ||
- | |||
- | <code>apt-get -b source serviio</code> | ||
- | |||
- | For further assistance or questions regarding this package write to debian [@] i-matrixx [dot] de. | ||
- | |||
- | == 2.3 Manual installation from [[http://www.serviio.org/download]] == |