Skip to content

Environment Variables

Environment variables allow you to modify how TVApp2 functions within a docker container. Ensure that you understand the setting you are changing before you modify these values, otherwise, TVApp2 may fail to start due to misconfigurations.


TZ

1.0.0 Etc/UTC

The TZ environment variable specifies the timezone that your docker container will utilize. This is useful for syncing your local time with console outputs such as our logging system.

docker-compose.yml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
services:
    tvapp2:
        container_name: tvapp2
        image: ghcr.io/thebinaryninja/tvapp2:latest
        restart: unless-stopped
        volumes:
            - /etc/timezone:/etc/timezone:ro
            - /etc/localtime:/etc/localtime:ro
            - /var/run/docker.sock:/var/run/docker.sock
            - ./config:/config
            - ./app:/usr/bin/app
        environment:
            - TZ=Etc/UTC # (1)
  1. ℹ Changing this env variable will change the time for anything related to the TVApp2 docker container.
  Etc/UTC
  Africa/Cairo
  Africa/Johannesburg
  Africa/Lagos
  America/Argentina/Buenos_Aires
  America/Bogota
  America/Caracas
  America/Chicago
  America/El_Salvador
  America/Juneau
  America/Lima
  America/Los_Angeles
  America/Mexico_City
  America/New_York
  America/Phoenix
  America/Santiago
  America/Sao_Paulo
  America/Toronto
  America/Vancouver
  Asia/Almaty
  Asia/Ashkhabad
  Asia/Bahrain
  Asia/Bangkok
  Asia/Chongqing
  Asia/Dubai
  Asia/Ho_Chi_Minh
  Asia/Hong_Kong
  Asia/Jakarta
  Asia/Jerusalem
  Asia/Kathmandu
  Asia/Kolkata
  Asia/Kuwait
  Asia/Muscat
  Asia/Qatar
  Asia/Riyadh
  Asia/Seoul
  Asia/Shanghai
  Asia/Singapore
  Asia/Taipei
  Asia/Tehran
  Asia/Tokyo
  Atlantic/Reykjavik
  Australia/ACT
  Australia/Adelaide
  Australia/Brisbane
  Australia/Sydney
  Europe/Athens
  Europe/Belgrade
  Europe/Berlin
  Europe/Copenhagen
  Europe/Helsinki
  Europe/Istanbul
  Europe/London
  Europe/Luxembourg
  Europe/Madrid
  Europe/Moscow
  Europe/Paris
  Europe/Riga
  Europe/Rome
  Europe/Stockholm
  Europe/Tallinn
  Europe/Vilnius
  Europe/Warsaw
  Europe/Zurich
  Pacific/Auckland
  Pacific/Chatham
  Pacific/Fakaofo
  Pacific/Honolulu
  Pacific/Norfolk
  US/Mountain


WEB_IP

1.0.0 0.0.0.0

The WEB_IP environment variable allows you to define what IP address will be bound to the TVApp2 docker image.

docker-compose.yml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
services:
    tvapp2:
        container_name: tvapp2
        image: ghcr.io/thebinaryninja/tvapp2:latest
        restart: unless-stopped
        volumes:
            - /etc/timezone:/etc/timezone:ro
            - /etc/localtime:/etc/localtime:ro
            - /var/run/docker.sock:/var/run/docker.sock
            - ./config:/config
            - ./app:/usr/bin/app
        environment:
            - WEB_IP=0.0.0.0 # (1)
  1. ℹ Specify 0.0.0.0 to bind to all local IP addresses.


WEB_PORT

1.0.0 4124

The WEB_PORT environment variable allows you to define what port the TVApp2 docker container will listen to.

docker-compose.yml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
services:
    tvapp2:
        container_name: tvapp2
        image: ghcr.io/thebinaryninja/tvapp2:latest
        restart: unless-stopped
        volumes:
            - /etc/timezone:/etc/timezone:ro
            - /etc/localtime:/etc/localtime:ro
            - /var/run/docker.sock:/var/run/docker.sock
            - ./config:/config
            - ./app:/usr/bin/app
        environment:
            - WEB_IP=4124 # (1)
  1. ℹ The default port is 4124


URL_REPO

1.0.0 https://git.binaryninja.net/binaryninja

The URL_REPO environment variable allows you to specify what Github repo is used to communicate with in order to fetch IPTV data. This is used as an internal environment variable by the developers and should not be changed by the end-user; otherwise you will be unable to fetch IPTV data.

docker-compose.yml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
services:
    tvapp2:
        container_name: tvapp2
        image: ghcr.io/thebinaryninja/tvapp2:latest
        restart: unless-stopped
        volumes:
            - /etc/timezone:/etc/timezone:ro
            - /etc/localtime:/etc/localtime:ro
            - /var/run/docker.sock:/var/run/docker.sock
            - ./config:/config
            - ./app:/usr/bin/app
        environment:
            - URL_REPO=https://git.binaryninja.net/binaryninja # (1)
  1. ⚠ It is highly recommended that you do not change this value otherwise you will not be able to download the latest M3U playlists and EPG guide data.


DIR_BUILD

1.0.0 /usr/src/app

The DIR_BUILD environment variable specifies what local folder will be utilized by the TVApp2 docker container when the container builds the app.

docker-compose.yml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
services:
    tvapp2:
        container_name: tvapp2
        image: ghcr.io/thebinaryninja/tvapp2:latest
        restart: unless-stopped
        volumes:
            - /etc/timezone:/etc/timezone:ro
            - /etc/localtime:/etc/localtime:ro
            - /var/run/docker.sock:/var/run/docker.sock
            - ./config:/config
            - ./app:/usr/bin/app
        environment:
            - DIR_BUILD=/usr/src/app # (1)
  1. ⚠ You should not change this unless you are an advanced user.


DIR_RUN

1.0.0 /usr/src/app

The DIR_RUN environment variable specifies what local folder will be utilized by the TVApp2 docker container when the container has built the app and placed it into a production folder.

docker-compose.yml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
services:
    tvapp2:
        container_name: tvapp2
        image: ghcr.io/thebinaryninja/tvapp2:latest
        restart: unless-stopped
        volumes:
            - /etc/timezone:/etc/timezone:ro
            - /etc/localtime:/etc/localtime:ro
            - /var/run/docker.sock:/var/run/docker.sock
            - ./config:/config
            - ./app:/usr/bin/app
        environment:
            - DIR_RUN=/usr/bin/app # (1)
  1. ⚠ You should not change this unless you are an advanced user.


STREAM_QUALITY

1.1.0 hd

The STREAM_QUALITY environment variable specifies the default stream quality that will be used when you initiate a new channel to view.

Available Options:

  • hd High Definition
  • sd Standard Definition
docker-compose.yml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
services:
    tvapp2:
        container_name: tvapp2
        image: ghcr.io/thebinaryninja/tvapp2:latest
        restart: unless-stopped
        volumes:
            - /etc/timezone:/etc/timezone:ro
            - /etc/localtime:/etc/localtime:ro
            - /var/run/docker.sock:/var/run/docker.sock
            - ./config:/config
            - ./app:/usr/bin/app
        environment:
            - STREAM_QUALITY=hd # (1)
  1. ℹ This environment variable has the following options:
    • hd
    • sd


FILE_PLAYLIST

1.1.0 playlist.m3u8

The FILE_PLAYLIST environment variable specifies the filename that will be utilized when your .m3u playlist file is generated.

docker-compose.yml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
services:
    tvapp2:
        container_name: tvapp2
        image: ghcr.io/thebinaryninja/tvapp2:latest
        restart: unless-stopped
        volumes:
            - /etc/timezone:/etc/timezone:ro
            - /etc/localtime:/etc/localtime:ro
            - /var/run/docker.sock:/var/run/docker.sock
            - ./config:/config
            - ./app:/usr/bin/app
        environment:
            - FILE_PLAYLIST=playlist.m3u8 # (1)
  1. ℹ Changing this file only changes the filename locally; it does not affect the server-side fetching mechanism.


FILE_EPG

1.1.0 xmltv.xml

The FILE_EPG environment variable specifies the filename that will be utilized when your .xml EPG playlist file is generated.

docker-compose.yml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
services:
    tvapp2:
        container_name: tvapp2
        image: ghcr.io/thebinaryninja/tvapp2:latest
        restart: unless-stopped
        volumes:
            - /etc/timezone:/etc/timezone:ro
            - /etc/localtime:/etc/localtime:ro
            - /var/run/docker.sock:/var/run/docker.sock
            - ./config:/config
            - ./app:/usr/bin/app
        environment:
            - FILE_EPG=xmltv.xml # (1)
  1. ℹ Changing this file only changes the filename locally; it does not affect the server-side fetching mechanism.


FILE_GZIP

1.1.0 xmltv.xml.gz

The FILE_GZIP environment variable specifies the filename that will be utilized when a compressed .gzip is generated and when you download the file.

docker-compose.yml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
services:
    tvapp2:
        container_name: tvapp2
        image: ghcr.io/thebinaryninja/tvapp2:latest
        restart: unless-stopped
        volumes:
            - /etc/timezone:/etc/timezone:ro
            - /etc/localtime:/etc/localtime:ro
            - /var/run/docker.sock:/var/run/docker.sock
            - ./config:/config
            - ./app:/usr/bin/app
        environment:
            - FILE_GZIP=xmltv.xml.gz # (1)
  1. ℹ Changing this file only changes the filename locally for generation and downloading. It does not affect the server-side fetching mechanism.


LOG_LEVEL

1.1.0 4

The LOG_LEVEL environment variable allows you specify how deep logs should go when being output to your console.

docker-compose.yml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
services:
    tvapp2:
        container_name: tvapp2
        image: ghcr.io/thebinaryninja/tvapp2:latest
        restart: unless-stopped
        volumes:
            - /etc/timezone:/etc/timezone:ro
            - /etc/localtime:/etc/localtime:ro
            - /var/run/docker.sock:/var/run/docker.sock
            - ./config:/config
            - ./app:/usr/bin/app
        environment:
            - LOG_LEVEL=4 # (1)
  1. ℹ The default log level is 4 (info).
Log Level Name Description
6 Trace Displays all possible logs in console, along with anything below this line.
5 Debug Displays debug / developer logs, along with anything below this line.
4 Info Displays informative logs, along with anything below this line.
3 Notice Displays important notices, along with anything below this line.
2 Warm Displays warnings, along with anything below this line.
1 Error Displays only errors, none of the log levels above this line will be shown