TVIP Knowledge Base TVIP AppStore Installation

TVIP AppStore Installation

Introduction:
This guide shows how to install a simple TVIP AppStore that can be used to create markets and manage apps. The installation is done with Docker.

Requirements:
For this installation, you need a web server, Docker, and Docker Compose.

Create the folder and file:
Create a new folder in your file system. Choose a folder name that you can easily recognize later. Then create a file named docker-compose.yml inside this folder.

Copy the docker-compose.yml shown below and then adjust it to your requirements.

x-common-variables: &common-variables
  LE_FQDN: test.example.com
  TZ: GMT


services:
  nginx:
    image: den1s/nginx-tvip-app-store:release
    container_name: nginx
    hostname: nginx
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./var/etc/ssl:/etc/nginx/ssl
    environment:
      <<: *common-variables
      LETSENCRYPT: 'true'
      LE_EMAIL: user@example.com
      #- SSL_CERT=le-crt.pem
      #- SSL_KEY=le-key.pem
      #- SSL_CHAIN_CERT=le-chain-crt.pem

  tvip-app-store:
    image: den1s/tvip-app-store:release
    volumes:
      - ./web:/srv/markets
    environment:
      <<: *common-variables
      ADMIN_PASSWORD: test-admin-password
    hostname: tvip-app-store
    container_name: tvip-app-store

TVIP App Store Installation

Edit the file:
Then edit the file according to your requirements.

Required:
LE_FQDN: Enter your actual domain name here, for example appstore.example.com.
TZ: Adjust this value to your time zone.
LETSENCRYPT: If this value is set to true, your AppStore will be provided via HTTPS. The certificates will be requested automatically via Let’s Encrypt.
LE_Email: Enter your email address here. It is required for Let’s Encrypt.
ADMIN_PASSWORD: Set the desired password for the admin interface here.

Optional:
SSL_CERT if LETSENCRYPT is set to false, you can add your own certificates. This option is disabled by default.
SSL_KEY if LETSENCRYPT if LETSENCRYPT is set to false, you can add your own certificates. This option is disabled by default.
SSL_CHAIN_CERT if LETSENCRYPT if LETSENCRYPT is set to false, you can add your own certificates. This option is disabled by default.

Start the containers:
For the next step, you need a command line.

Use cd to switch to the directory where your docker-compose.yml file is located. Then start the containers with the following command:

docker-compose up -d

Open in the browser:
After running the command, the AppStore can be opened in the browser, for example at https://appstore.example.com

Login:
Then log in with the username admin and the password you set earlier.

Completion:
The installation of the TVIP AppStore is now complete. You can now use the web interface to create markets and fill them with selected APK files. The AppStore can then be deployed to TVIP STBs via provisioning.

You can find out how to integrate your STB via provisioning in the TVIP Provisioning Scheme. Alternatively, the preparation can also be done via the TVIP XML-Generator.