TVIP TMS install guide

System requirements:

  • 4 Core CPU
  • Minimum 16GB of RAM

WARNING: TVIP TMS in BETA stage, please report all bugs to

Ubuntu users

Supported version: 16.04 LTS

We have quick way to installation on Ubuntu 16.04 - check instructions here

First - check your system locale, if your locale is not UTF-8 you might setup correct locale (system locale influence to postgresql cluster).

locale -a

if you not seen UTF-8 entries in output, you need setup (change en_US code to your region):

locale-gen en_US.UTF-8
dpkg-reconfigure locales

Locale change after system reboot:


Add repository to system:

echo "deb xenial main" >> /etc/apt/sources.list.d/tms.list
wget --quiet -O - | apt-key add -
apt-get update

Install dependencies:

  • openjdk-java or oracle java (version 10 or above), tvip-tms package has as dependency java10-runtime, oracle impementation of java available in tvip repository.
  • postgresql server (version 9.2 or above)
apt-get install postgresql
  • elasticsearch (version 6.2.3 or above)
apt-get install elasticsearch

Install TVIP TMS:

apt-get install tvip-tms

CentOS users

Supported version: 7

Add repository to system:

cd /etc/yum.repos.d/

Install dependencies:

  • openjdk-java or oracle java (version 10 or above)
  • postgresql server (version 9.2 or above)
  • elasticsearch (version 6.2.3 or above)

Install TVIP TMS:

yum install tvip-tms

Configure and start

  • Switch to postgres user
root@tms:~# su postgres
  • Create tvip-tms user:
postgres@tms:~# createuser tvip-tms
  • Create database for tvip-tms:
createdb tvip-tms -O tvip-tms

Configure pg_hba.conf:

On ubuntu this configuration located at /etc/postgresql/<pg_version>/main/pg_hba.conf

On centos this configuration located at /var/lib/pgsql/data/pg_hba.conf

Set access restriction for local, ::1/128 to trust:

# "local" is for Unix domain socket connections only
local   all             all                                     trust
# IPv4 local connections:
host    all             all               trust
# IPv6 local connections:
host    all             all             ::1/128                 trust

This option allow passwordless access to all databases from localhost (not for remote connections).

Restart postgres service

service postgresql restart

Default database configuration (/opt/tvip-tms/


Enable service:

systemctl enable tvip-tms

#start service
service tvip-tms start

Enable elasticsearch

systemctl enable elasticsearch

#start service
service elasticsearch start

Check installation

Admin panel located at


Default user admin has password admin

Fresh installation contains examples of channels, accounts, etc…

Ubuntu 16.04, CentOS 7: application logs available by:

journalctl -f -u tvip-tms

Ubuntu 14.04: application logs available by:

tail -f /var/log/tvip-tms.log

On all OS access log available in /var/log/tms/.

Additional configuration

VoD meta import For TMDB automated media import you will request API key here and add they to configuation:

  1. Create new property: tmdb_api_key, set your API key to that property

Migration from TVIP Middleware version 2

For migration to TMS you need fetch dump tvip-middleware database and restore database on new server (see instructions below)

Be careful: database from TMS is not compatible with TVIP Middleware 2, but TVIP Middleware 2 database is allow to use with TVIP TMS

How to backup tvip-middleware (not TMS) database

  • Get database name at /usr/local/etc/tvipmw.yml, usually this name is tvip_middleware
  • Switch to postgres user from root user and change current directory to rw allowed path
root@mw:~# su postgres
postgres@mw:~# cd /var/lib/postgresql/9.3/

Make dump:

postgres@mw:~/9.3$ pg_dump tvip_middleware > tvip_middleware.sql

Transfer generated file to another host ( for backup or migration cases ) For secure copy (over ssh) use command:

postgres@mw:~/9.3$ scp tvip_middleware.sql

How to restore tvip-middleware database to FRESH TVIP TMS

If you use tvip-middleware previously:

postgres@tms:~# psql -u tvip-tms tvip-tms < /path/to/dump/tvip-middleware.sql

WARNING: tvip-middleware backup might be restore before FIRST run of tvip-tms

Translations of this page: