MCPcopy Index your code
hub / github.com/RafhaanShah/Container-Mon

github.com/RafhaanShah/Container-Mon @v1.1.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.1.1 ↗ · + Follow
12 symbols 27 edges 1 files 0 documented · 0% ● updated 6d agov1.1.1 · 2025-09-12★ 75
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Container-Mon

Get notified when your Docker containers are unhealthy.

screenshot

Prerequisites

  • A notification service supported by Shoutrrr and the required API keys or other configuration for your chosen service (e.g: Telegram, Discord, Slack, Teams etc)

Building

Build the app:

go build

Format:

gofmt -w -s .

Configuration

Configuration can be set via environment variables or command line flags. Command line flags take precedence over environment variables. Only CONTAINERMON_NOTIFICATION_URL (or --notification-url) is mandatory; all other fields are optional.

Environment Variable Command Line Flag Type Default Value Description
CONTAINERMON_FAIL_LIMIT --fail-limit Int 1 Number of consecutive 'unhealthy' checks to reach before sending a notification
CONTAINERMON_CRON --cron String /5 ** * Standard Cron schedule of when to run healthchecks
CONTAINERMON_NOTIFICATION_URL --notification-url String N/A Notification URL for Shoutrrr. Multiple services can be used with the \| (pipe) character as a separator.
CONTAINERMON_HEALTHY_NOTIFICATION_URL --healthy-notification-url String N/A Notification URL for healthy state notifications
CONTAINERMON_USE_LABELS --use-labels Bool false If true, only monitor containers with the label containermon.enable=true set
CONTAINERMON_NOTIFY_HEALTHY --notify-healthy Bool true If true, send a notification when an 'unhealthy' container returns to being 'healthy'
CONTAINERMON_CHECK_STOPPED --check-stopped Bool true If true, consider stopped containers as 'unhealthy'. If false, only containers with a healthcheck set are monitored
CONTAINERMON_MESSAGE_PREFIX --message-prefix String N/A Custom text to be prefixed to all notification messages.
CONTAINERMON_CHECK_EXIT_CODE --check-exit-code Bool false When set to true, only exited containers with a non-zero exit code will be marked as unhealthy
DOCKER_HOST String /var/run/docker.sock Path for the Docker API socket
DOCKER_API_VERSION String docker default Docker API version to use
DOCKER_CERT_PATH String docker default Path to load the TLS certificates from
DOCKER_TLS_VERIFY Bool false Enable or disable TLS verification

Usage

Stand-alone

go run app.go --notification-url "telegram://token@telegram?channels=channel-1" --fail-limit=3 --cron="*/2 * * * *"

Docker

docker run \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e CONTAINERMON_NOTIFICATION_URL=telegram://token@telegram?channels=channel-1 \
  ghcr.io/rafhaanshah/container-mon:latest

Docker-Compose

version: "3.8"
services:
  container-mon:
    container_name: container-mon
    image: ghcr.io/rafhaanshah/container-mon:latest
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - CONTAINERMON_NOTIFICATION_URL=telegram://token@telegram?channels=channel-1

Troubleshooting

  • Docker API version issues: if you get error messages like client version 1.43 is too new. Maximum supported API version is 1.42 then please set the DOCKER_API_VERSION environment variable to the latest version supported by your Docker engine (e.g. DOCKER_API_VERSION=1.42), which you can check by running docker version.
  • Notifier issues: please check if your URL works with the Shoutrrr CLI here.

Security Considerations

  • It can be considered a security risk to directly map your Docket socket inside a container. A proxy such as Socket-Proxy can be used to give fine-grained access to parts of the Docker API, this application only needs to be able to read a list of running containers ->

```shell

docker run \ -e DOCKER_HOST=tcp://socket-proxy:2375 ...

```

```shell docker run \ -u $(id -u):$(stat -c '%g' "/var/run/docker.sock") \ ...

```

License

MIT

Core symbols most depended-on inside this repo

getEnvBool
called by 4
app.go
getEnv
called by 4
app.go
notify
called by 2
app.go
checkContainers
called by 1
app.go
containerInList
called by 1
app.go
getContainers
called by 1
app.go
isHealthy
called by 1
app.go
getConfig
called by 1
app.go

Shape

Function 11
Struct 1

Languages

Go100%

Modules by API surface

app.go12 symbols

For agents

$ claude mcp add Container-Mon \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact