Sign inSign up

mwalbeck/twitchlite

By mwalbeck

Updated about 2 months ago
Archived

A lightweight livestream indexer for twitch.tv

Image
0

6.9K

mwalbeck/twitchlite repository overview

docker-twitchlite

Build Status Docker Pulls

Docker container for twitchLite. For more information about twitchLite please checkout the project page.

You can find the image on Docker Hub and the source code can be found here with a mirror on github.

Usage

This is an php-fpm based image, which means it only runs an php-fpm process, and a separate webserver is needed to access twitchLite.

Configuration

The docker container is intended to be configure through ENV variables, and you have the following options:

ENV VARdefaultalloweddescription
UID1000Any UIDThe user id the container runs as
GID1000Any GIDThe group id the container runs as
OAUTH_TOKEN--Your twitch api v5 token
ONLY_FOLLOWED_DEFAULTfalsetrue or falseIf only channels you follow should be shown by default
DEFAULT_LIMIT251-100How many livestreams to show at once
GET_TOP_GAMESfalsetrue or falseIf a list of the currently most played games should be retrieved for autocompletion
TOP_GAMES_LIMIT101-100How many of the currently most played games should be retrieved
Webserver

Since this is only a php-fpm container, you also need a webserver to serve the site. With that you need a shared volume between the 2 containers mounted at /var/www/twitchlite. You can have a look at the docker-compose file below for an example.

This is a pretty basic PHP site, so a basic nginx php-fpm config will work. Though I will note that access should only be given to index.php, and you can safely deny access to all other php files, especially the config.php file, which will contain your twitch oauth token, if you provide one.

Docker-compose example

Here is an example docker-compose file you can use to setup twitchLite

version: '2'

volumes:
  twitchlite:

networks:
  frontend:

services:
  twitchlite:
    image: mwalbeck/twitchlite
    restart: on-failure:5
    networks:
      - frontend
    volumes:
      - twitchlite:/var/www/twitchlite
    environment:
      UID: "1000"
      GID: "1000"
      OAUTH_TOKEN: "YOUR-OAUTH-TOKEN-HERE"
      ONLY_FOLLOWED_DEFAULT: "false"
      DEFAULT_LIMIT: "25"
      GET_TOP_GAMES: "true"
      TOP_GAMES_LIMIT: "100"

  nginx:
    image: nginx
    restart: on-failure:5
    networks:
      - frontend
    volumes:
      - "twitchlite:/var/www/twitchlite:ro"
    ports:
      - "443:443"
      - "80:80"

Tag summary

Content type

Image

Digest

sha256:e553379b6

Size

170.5 MB

Last updated

about 2 months ago

docker pull mwalbeck/twitchlite