cherryEPG has been developed on Debian Linux. As such it can be run on any Linux derivative. Historically we were used to work on a Debian based distribution. Setting up a Debian system is quit easy but the fine tuning is not for beginners. Practice has shown that it’s much easier to use a more user friendly Debian-based distribution.

The decision was made on Turnkey Linux. As you can read from their website, Turnkey Linux is Debian GNU/Linux with Batteries Included.

The installation process and even later operation doesn’t require special knowledge of Linux operating system. But further or later it could be helpful to customize it to your needs.

Installation of the operating system

Installation of cherryEPG starts on an up and running Turnkey Mysql appliance. Please install this appliance on a Bare Metal physical machine or in a Virtual environment of your choice. You can get the required installation files here.

Turnkey Linux has published a new version of their appliance - 16.0. Because of some minor problems cherryEPG will not install on this release without manual intervention.
For a straightforward installation please use Turnkey Mysql version 15.1.

Turnkey Linux has all the relevant security functions installed, but it is not recommended to operate a cherryEPG directly on the Internet without using an updated firewall.

During the installation you will be asked to enter a password for the administrator of the system the root user and the database administrator the adminer user.

When asked for using the TurnKey Backup and Migration (TKLBAM) you can easily skip, expect you intend to use this feature. You can read more on this functionality here.

cherryEPG does not rely on TKLBAM functionality or the TurnkeyHub service.

Normally you should end-up with something like this.

confconsole interface

configuration application

Depending on your environment you need to change the network settings, hostname and timezone. This can be done also later from the shell by running the tool


After successful installation of the operating system you can login to the console - shell. This can be done via a ssh client like putty or from CLI if you are running a Linux system.

Turnkey Linux is providing also a handy feature which allows you to connect over ssh just by using your browser - shellinabox. Point your browser to https://ip_address_of_your_new_system:12320 .

The certificate is self-signed therefore you will receive a warning “Potential Security Risk Ahead”. Accept the certificate and go on.

Now login as root user with you previously defined password.

When you end up with something like this you are ready to continue with the installation of cherryEPG.

successful login

shell after installation

Installation of cherryepg Debian package

Before doing modifications on a system It is always good to update the package database and install all outstanding updates. As root user run this

apt update; apt upgrade -y

The installation of cherryEPG will be done with an advanced package manager gdebi which needs to be installed first. Run

apt install gdebi

Now download the cherryepg.deb packet from our web-page with


and install it with the package manager

gdebi cherryepg.deb

During the installation of the package a new user cherryepg has been added to the system. This user is used for all cherryepg tasks. Set a password for the new user by running

passwd cherryepg

Now open a new ssh connection to the server and login as the new user cherryepg to continue with the installation procedure.

Get the cherryEPG software from the repository by running

cd cherryTool
git pull

cherryEPG is written in perl, don’t be afraid, you don’t need to write a line of code, and some additional modules are required. These will be installed by running

cherryUpdate -d

Sometimes you need to run this command multiple times as there are cross dependencies. When you get

--> Working on .
Configuring /var/lib/cherryepg/cherryTool ... OK
<== Installed dependencies for .. Finishing.

you are on the right side.

By running

cherryUpdate -i

you will create the cherryEPG database and user for accessing it. When asked for the password, you have to enter the adminer password you’ve entered during the TurnkeyLinux install process.

Finally run

cherryUpdate -r

to set-up a demo configuration.

The last step is to restart two services running in background. These are the output stream carousel ringelspiel and the web-application cherryWeb. Login as root user and execute

systemctl restart cherryWeb
systemctl restart ringelspiel

An alternative is to reboot the machine.

Now you can connect to the web-interface https://ip_address_of_your_new_system:12323 and login as cherryepg user. Read more.

login screen

enter credentials