# Monocker

Monocker is a self-hosted infrastructure app. Monocker monitors the state of your Docker containers and sends an alert whenever a container starts, stops, pauses, or exits. It is open source and self-hosted, installable on Proxmox, Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/980/monocker

## Description

Monocker monitors the state of your Docker containers and sends an alert whenever a container starts, stops, pauses, or exits. It lets you include or exclude specific containers and optionally limit alerts to paused, exited, unhealthy, or dead states. Notifications can be delivered through Telegram, Pushbullet, Pushover, Discord, Ntfy, Slack, Gotify, Matrix, or Apprise. It is a lightweight, self-hosted option for homelabbers who want simple container status alerts without running a full monitoring stack.

## Platform availability

Available on 2 of 9 platforms: Unraid, Proxmox.

## Health score

22/100 (Low), based on 3 of 4 factors.
- Maintained: 1 (last commit 716 days ago)
- Popular: 46 (202 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=monocker
- Docker Hub: https://hub.docker.com/r/petersem/monocker
- Unraid: https://ca.unraid.net/apps/monocker-133xb6x0qxufdx?q=monocker

## Common questions

### How can I reduce Monocker alerts when containers frequently change state?

Set ONLY_OFFLINE_STATES to true so Monocker only alerts when a container becomes paused, exited, running (unhealthy), or dead. Set EXCLUDE_EXITED to true if you do not want exited containers included at all.

### Can Monocker monitor a Docker daemon on another host?

Set DOCKER_HOST to a unix socket, Windows named pipe, or TCP connection. Mount the socket or pipe as a volume if you use a local path, and ensure a proxied Docker endpoint allows GET requests on /containers.

### How do I point Monocker at a custom ntfy server?

Use ntfy@topic_title in MESSAGE_PLATFORM and provide CUSTOM_NTFY_SERVER, NTFY_USER, and NTFY_PASS for the custom ntfy server. These options are shown in the Monocker deployment example.

### Can one Monocker instance send alerts to multiple message platforms?

No, MESSAGE_PLATFORM accepts only one messaging platform. Run separate Monocker instances for different platforms and use SERVER_LABEL or SERVER_AVATAR to identify which server sent each message.

### How can I include the container ID in Monocker notifications?

Set SHA to true. This includes the container SHA ID in the messages sent by Monocker.

---
Source: Our Local Host (https://ourlocalhost.com/app/980/monocker), the self-hosted and open-source app directory.