foorschtbar/awtrix2 repository overview

⁠Docker Image for AWTRIX2

⁠ ⁠

Multi-Arch/Multi-Platform Docker Container for AWTRIX2⁠. The Container downloads latest AWTRIX Host (Server) on start or restart, but you could disabled this. Default is the stable version, but you could also switch to the beta or nightly branch.

• GitHub: foorschtbar/awtrix-docker⁠
• Docker Hub: foorschtbar/awtrix2⁠

⁠Usage

Example docker-compose configuration:

version: "3"

services:
  awtrix:
    image: foorschtbar/awtrix2
    restart: unless-stopped
    ports:
      - "7000:7000"
      - "7001:7001"
      - "5568:5568"
    volumes:
      - ./data:/data
      - /sys/class/net/<your network interface>/address:/data/hostmac:ro
    environment:
      - TZ=Europe/Berlin
      - JAVA_TOOL_OPTIONS="-Duser.language=de -Duser.country=DE"

⁠Persistent data

Add a volume or redirect to a folder on host.

    volumes:
        - ./data:/data

⁠Language

If you want AWTRIX to automatically display some apps like DayOfTheWeek in your local language/format (e.g. "Sonntag" instead of "Sunday") you can specify this with an eviroment variable.

    environment:
        - TZ=Europe/Berlin
        - JAVA_TOOL_OPTIONS="-Duser.language=de -Duser.country=DE"

• Where de is your two-letter language code. (see ISO 639-2⁠)
• And DE is your two-letter country code. (see ISO 3166-1 alpha-2⁠)

⁠Premium Users

AWTRIX Premium uses the MAC-Adress of the primary network interface for license binding. To avoid losing premium features (See awtrixdocs.blueforder.de⁠), pass the host MAC to AWTRIX:

    volumes:
      - /sys/class/net/<eth0 or different network interface>/address:/data/hostmac

or run the container in host mode:

    #ports:
    # - "7000:7000"
    # - "7001:7001"
    # - "5568:5568"
    network_mode: host

⁠Autoupdate

To disable autoupdate on start/restart, set AWTRIX_AUTOUPDATE to false:

    environment:
      - AWTRIX_AUTOUPDATE=false

⁠Logger output

This container logs as default to stdout. You can change this back to file (AWTRIX default):

    environment:
      - AWTRIX_LOGGER=file

⁠Beta/Nightly versions

To use beta or nightly versions, set environment variable AWTRIX_UPDATE_CHANNEL to:

• beta or
• nightly

Example:

    environment:
      - AWTRIX_UPDATE_CHANNEL=beta

⁠Credits

The Container is based on the wHyEt/Awtrix2-Docker⁠ image.