l33tlamer/monocker repository overview

⁠DEPRECATED

⁠PLEASE USE petersem/monocker⁠ INSTEAD

⁠Monocker

• Platform tags: armv6, armv7, armv8 and amd64
• latest tag defaults to armv8, tested with Raspi 3B+
• All images are the same software version, currently 2.6.1 (as of 22/05/2023)
• Pull from the Docker Hub repo⁠ with docker pull docker.io/l33tlamer/monocker:<tag>
• Alternatively use the GitHub repo⁠ with docker pull ghcr.io/l33tlamer/monocker:<tag>

No changes whatsoever have been done to the actual software and Dockerfile used.
These are simply arm-compatible images because they are not offered by the original creator.

Absolutely all credit goes to the creator of the software:

⁠https://github.com/petersem/monocker⁠

⁠Description from the original GitHub page:

⁠"Monitors Docker (MONitors dOCKER) containers and alerts on 'state' change"

Features:

• Telegram integration
• Pushbullet integration
• Pushover integration
• Discord integration (via webhooks)
• Monitors 'state' changes for all containers (every 10 seconds)
• Specific inclusions or exclusions of containers to monitor
• Optionally, only alert on state changes to (paused, exited, running (unhealthy), or dead)

⁠Docker compose example:

version: '2.4'

services:
  monocker:
    container_name: monocker
    image: petersem/monocker
    environment:
      # Optional label to preface messages. Handy if you are running multiple versions of Monocker
      SERVER_LABEL: 'Dev'
      # Specify the messaging platform and details, or leave blank if only wanting container logs (pick one only)
      MESSAGE_PLATFORM: 'telegram@your_bot_id@your_chat_id'
      # MESSAGE_PLATFORM: 'pushbullet@your_api_key@your_device_id'
      # MESSAGE_PLATFORM: 'pushover@your_user_key@your_app_api_token'
      # MESSAGE_PLATFORM: 'discord@webhook_url'
      # MESSAGE_PLATFORM: ''
      # Optional - includes or excludes specified containers - default behaviour is false
      LABEL_ENABLE: 'false'
      # Optional - only show when container state changes to being offline (paused, exited, running (unhealthy), or dead) - default is false
      ONLY_OFFLINE_STATES: 'false'
      # [Optional] - Regardless of any other settings, you can ignore or include 'exited'
      EXCLUDE_EXITED: 'false'      
      # [Optional] - Set the poll period in seconds. Defaults to 10 seconds, which is also the minimum. 
      PERIOD: 10
      # [Optional] - Supress startup messages from being sent. Default is false
      DISABLE_STARTUP_MSG: 'false'
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    restart: unless-stopped

• For Telegram: See documentation for how to obtain ID values.
• For Pushbullet: Open Pushbullet in a browser and get device ID from URL Example⁠
• For Pushover: See pushover doco for user key and app token
• For Discord: See Discord doco for how to create a webhook and get the url

⁠LABEL_ENABLE

This is an optional value, and defaults to false if it is not specified. This feature allows you to specify (with labels) 'either' specific containers to monitor or exclude from monitoring.

• If it is set to false, then all containers will be monitored except for ones with the following label in their YAML.

    labels:
      monocker.enable: 'false'

• If it is set to true, only containers with the following label will be monitored

    labels:
      monocker.enable: 'true'

If you just want to monitor everything, then set LABEL_ENABLE: 'false' or just leave it out altogether.

⁠End of original description

No changes whatsoever have been done to the actual software and Dockerfile used.
These are simply arm-compatible images because they are not offered by the original creator.

Absolutely all credit goes to the creator of the software:

⁠https://github.com/petersem/monocker⁠