Alan Doyle

   Docker Images

featured image
Table of Contents

I maintain a small number of personal Docker images on DockerHub which others may find useful.

DOKUWIKI

An enhanced Dokuwiki installation with some extra features.

Docker

Available on DockerHub

docker pull alandoyle/dokuwiki

Usage

docker run --name=dokuwiki \
  -d --init \
  -v <MY_CONF_PATH>:/var/www/html/conf \
  -v <MY_DATA_PATH>:/var/www/html/data \
  -p 8000:80/tcp \
  alandoyle/dokuwiki:latest

Docker compose example:

---
services:
  dokuwiki:
   image: alandoyle/dokuwiki:latest
   container_name: dokuwiki
   restart: unless-stopped
   init: true
   ports:
     - "8000:80/tcp"
   volumes:
     - ./dokuwiki/conf:/var/www/html/conf
     - ./dokuwiki/data:/var/www/html/data

Ports

Port Description
80/tcp HTTP

Volumes

Path Description
/var/www/html/conf path for Dokuwiki configuration files
/var/www/html/data path for Dokuwiki data files

SEARXNG

Updated SearXNG Docker image with allows easier customisation.

Docker

Available on DockerHub

docker pull alandoyle/searxng

Usage

docker run --name=searxng \
  -d --init \
  -v <MY_CONFIG_PATH>:/etc/searxng \
  -v <MY_DATA_PATH>:/var/cache/searxng \
  -v <MY_TEMPLATE_PATH>:/usr/local/searxng/searx/templates/simple \
  -v <MY_THEME_PATH>:/usr/local/searxng/searx/static/themes/simple \
  -p 8000:8080/tcp \
  alandoyle/searxng:latest

Docker compose example:

---
services:
  searxng:
   image: alandoyle/searxng:latest
   container_name: searxng
   restart: unless-stopped
   init: true
   ports:
     - "8000:8080/tcp"
   volumes:
     - ./searxng/config:/etc/searxng
     - ./searxng/data/:/var/cache/searxng
     - ./searxng/template:/usr/local/searxng/searx/templates/simple
     - ./searxng/theme:/usr/local/searxng/searx/static/themes/simple

Ports

Port Description
8080/tcp HTTP

Volumes

Path Description
/etc/searxng path for SearXNG configuration files
/var/cache/searxng path for SearXNG data/cache files
/usr/local/searxng/searx/templates/simple path for SearXNG template files
/usr/local/searxng/searx/static/themes/simple path for SearXNG template static files

FILEBOT

Filebot is the ultimate tool for renaming and organizing your movies, TV shows and Anime.

The graphical user interface (GUI) of the application can be accessed through a modern web browser, requiring no installation or configuration on the client.

Docker

Available on DockerHub

docker pull alandoyle/filebot

Usage

docker run --name=filebot \
  -d --init \
  -v <MY_DATA_PATH>:/data \
  -v <MY_MEDIA_PATH>:/media \
  -p 80:8080/tcp \
  -p 5900:5900/tcp \
  alandoyle/filebot:latest

Docker compose example:

---
services:
  filebot:
    image: alandoyle/filebot:latest
    container_name: filebot
    restart: unless-stopped
    init: true
    ports:
      - 80:8080  # If you want to go filebot through a browser
      - 5900:5900  # If you want to use a VNC client instead of the browser
    volumes:
      - /Storage/Incoming:/media
      - ./data:/data
    environment:
      - RESOLUTION=1600x900 # Change resolution (default: 1366x768)
      # - VNC_PASSWORD=8charpwd
    restart: always
    shm_size: "1gb"

Ports

Port Description
8080/tcp NOVNC HTTP Port
5900/tcp VNC Port

Volumes

Path Description
/data path for Filebot configuration files
/media path for Filebot media files

Filebot Licence

If you have a valid Filebot Licence then this file can be copied to the /data directory as .licence

This file is included in the email confirming registration and is in the following format…

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

<Licence details here>

-----END PGP SIGNATURE-----

Links to buy a yearly or lifetime licence can be found on the Filebot download page.

MEDIAELCH

MediaElch is a MediaManager for Kodi. Information about Movies, TV Shows, Concerts and Music are stored as NFO files. Fanarts are downloaded automatically from fanart.tv.

The graphical user interface (GUI) of the application can be accessed through a modern web browser, requiring no installation or configuration on the client.

Docker

Available on DockerHub

docker pull alandoyle/mediaelch

Usage

docker run --name=mediaelch \
  -d --init \
  -v <MY_CONFIG_PATH>:/config \
  -v <MY_MEDIA_PATH>:/media \
  -p 80:8080/tcp \
  -p 5900:5900/tcp \
  alandoyle/mediaelch:latest

Docker compose example:

---
services:
  mediaelch:
    image: alandoyle/mediaelch:latest
    container_name: mediaelch
    restart: unless-stopped
    init: true
    ports:
      - 80:8080  # If you want to go mediaelch through a browser
      - 5900:5900  # If you want to use a VNC client instead of the browser
    volumes:
      - /Storage/Incoming:/media
      - ./config:/config
    environment:
      - RESOLUTION=1600x900 # Change resolution (default: 1366x768)
      # - VNC_PASSWORD=8charpwd
    restart: always
    shm_size: "1gb"

Ports

Port Description
8080/tcp NOVNC HTTP Port
5900/tcp VNC Port

Volumes

Path Description
/config path for MediaElch configuration files
/media path for MediaElch media files

TT-RSS MYSQL

A simple Tiny Tiny RSS image which only supports MySQL with integrated feed updates.

  • Support MySQL server.
  • Built in Feed updating.
  • Built-in TT-RSS updating.

IMPORTANT NOTES

This Docker image has several assumptions/prerequisites which need to be fulfilled, ignoring them will bring failure.

  1. This Docker Image is for MySQL ONLY.
  2. This image is for domains or sub-domains with /tt-rss/ in the URL. e.g. http://reader.mydomain.tld
  3. MySQL needs to be installed in a separate Docker container.
  4. MySQL needs to be configured and setup BEFORE this image is deployed (explained below).
  5. If a previous MySQL instance is used and and old TT-RSS instance was using PHP 7.x then a “Data Fix” will need to be applied to the database as this image used PHP 8.1 and generates JSON differently. Failure to “Data Fix” the database could result in duplicate posts appearing in TT-RSS (explained below)

MySQL Setup

This image requires a database and database user be set up PRIOR to bringing up the image.

A new database and user can be created using the mysql command.

e.g. If you’re running the MySQL container from the Docker Compose example below you will need to run the following commands to create the database and user.

docker exec -it <MYSQL_CONTAINER> /bin/bash

Once inside the container run the following command to access MySQL.

mysql -u root -p

You will be prompted for the MYSQL_ROOT_PASSWORD (see Docker Compose example) Once in mysql run the following SQL commands to set up the database and user (see Docker Compose example to match up the values).

CREATE DATABASE <TTRSS_DB_NAME>;
CREATE USER '<TTRSS_DB_USER>' IDENTIFIED BY '<TTRSS_DB_PASS>';
GRANT ALL ON <TTRSS_DB_NAME>.* TO '<TTRSS_DB_USER>';
FLUSH PRIVILEGES;
\q

Now the tt-rss-mysql image can be started.

PHP 7 -> PHP 8 “Data Fix”

NOTE: If this is a fresh install of Tiny Tiny RSS then ignore this section.

PHP 7 stores the unique GUID used by each article in the following format:

{"ver":2,"uid":"2","hash":"SHA1:2b10b494802dc70e9d9d7676cdef0cf0f9969b78"}

PHP 8 stores the unique GUID used by each article in the following format:

{"ver":2,"uid":2,"hash":"SHA1:2b10b494802dc70e9d9d7676cdef0cf0f9969b78"}

Notice that the “uid” value is quoted with PHP 7 but not PHP 8.

The fix

To fix a previous MySQL database populated by PHP 7 the following SQL commands need to be used via the mysql commandline tool.

USE <TTRSS-DATABASE>;

UPDATE ttrss_entries
SET guid = replace(replace(guid,'"uid":"', '"uid":'),'", "hash":', ',"hash":')
WHERE guid LIKE '%"uid":"%"%';

Docker

Available on DockerHub

docker pull alandoyle/tt-rss-mysql

Usage

docker run --name=tt-rss-mysql \
  -d --init \
  -v <MY_CONF_PATH>:/opt/tt-rss/config.d\
  -v <MY_WEB_PATH>:/var/www/tt-rss\
  -p 8000:80/tcp \
  alandoyle/tt-rss-mysql:latest

Docker compose example:

---
services:
  mysql:
    image: mysql:8.0
    container_name: mysql
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: SecureSecretPassword
    volumes:
      - ./mysql/data:/var/lib/mysql
  tt-rss-mysql:
   image: alandoyle/tt-rss-mysql:latest
   container_name: tt-rss-mysql
   restart: unless-stopped
   init: true
   ports:
     - "8000:80/tcp"
    volumes:
      - ./tt-rss/web:/var/www/tt-rss
      - ./tt-rss/config:/opt/tt-rss/config.d
    environment:
      TTRSS_SELF_URL_PATH: https://reader.mydomain.tld
      TTRSS_DB_HOST: mysql
      TTRSS_DB_USER: ttrss_user
      TTRSS_DB_NAME: ttrss_database
      TTRSS_DB_PASS: ttrss_password
      TTRSS_DB_PORT: 3306
      TTRSS_FEED_UPDATE_CHECK: 600

Ports

Port Description
80/tcp HTTP

Volumes

Path Description
/var/www/tt-rss path for tt-rss web files
/opt/tt-rss/config.d path for tt-rss configuration files

Alan Doyle

Written by Alan Doyle.