An open API service indexing awesome lists of open source software.

https://github.com/cordalace/telepod

This is a read-only mirror from https://codeberg.org/cordalace/telepod
https://github.com/cordalace/telepod

notifications podman telegram

Last synced: about 1 year ago
JSON representation

This is a read-only mirror from https://codeberg.org/cordalace/telepod

Awesome Lists containing this project

README

          

# telepod

**Telepod** adds Telegram notifications feature to
[podman auto-update](https://docs.podman.io/en/latest/markdown/podman-auto-update.1.html).

Telepod looks up for running containers and checks if an image has changed since last run.
If the image has been updated Telepod sends a telegram message.

![Conversation example](https://cordalace.pages.dev/telepod-conversation-small.png "Conversation example")

## Environment variables

- `TELEGRAM_CHAT_ID`
- `TELEGRAM_BOT_TOKEN`

## Use with cron

```
*/5 * * * * TELEGRAM_CHAT_ID=-1003920707150 TELEGRAM_BOT_TOKEN=7917343448:906-MIX0YZRc6cHETY5KEmrDBA5fHW4Ye26 /usr/local/bin/telepod
```

## Use with systemd

File `~/.config/systemd/user/telepod.timer`:

```
[Unit]
Description=Telepod image update notifications

[Timer]
OnCalendar=*:0/5
Unit=telepod.target

[Install]
WantedBy=timers.target
```

File `~/.config/systemd/user/telepod.service`:

```
[Unit]
Description=Telepod image update notifications
After=network.target

[Service]
Type=oneshot
Environment="TELEGRAM_CHAT_ID=-1003920707150"
Environment="TELEGRAM_BOT_TOKEN=7917343448:906-MIX0YZRc6cHETY5KEmrDBA5fHW4Ye26"
ExecStart=/usr/local/bin/telepod
```

## User

Telepod tracks container versions of the current user. It could be
started as root or as regular user.

## Versions file

Telepod tracks image versions in json-file:

- `/var/lib/telepod/db.json` if started as root
- `$XDG_STATE_HOME/telepod/db.json` if started as regular user

## Repository mirrors

This project has [Github](https://github.com/cordalace/telepod) and
[Gitlab](https://gitlab.com/cordalace/telepod) mirrors, to contribute please use
[Codeberg](https://codeberg.org/cordalace/telepod).