Bots

Remote Proxmox VE cluster management through a Telegram chatbot — execute commands, monitor status and receive alerts from any device.

Features

• Remote Control

  ---

  Execute commands and manage nodes through Telegram bot.

• Notifications

  ---

  Receive notifications for cluster events and status changes.

• Access Control

  ---

  Restrict bot usage to a whitelist of authorised Telegram chat IDs; the token is stored encrypted at rest.

• Mobile Access

  ---

  Manage cluster from any device with Telegram app.

• Command Response

  ---

  Receive feedback on commands and system status.

• Chat Interface

  ---

  Execute operations through chat-based commands.

Why

Why a chatbot when the web UI is already there?

Cluster status from your phone

Check node uptime, VM state, last backup — without opening a browser or VPN-ing in. Anywhere Telegram works, the cluster does.

Push, not pull

Telegram delivers alerts and replies you initiated. No polling, no missed mail filter, no email password to keep current.

Authorised chats only

Only the chat IDs you whitelist can talk to the bot — the token is stored encrypted at rest.

Quick fire-and-forget

"Restart VM 200" from your phone while you walk to the data centre — no laptop, no SSH, no UI clicks.

Sections

• Telegram — status of the Telegram bot connection — token configured, chats whitelist, recent activity

Set Up Your Telegram Bot

To connect the Bots module to Telegram, you need to create a bot via BotFather and copy the generated token into the module settings.

1. Open the Telegram app on your phone or computer.

2. Search for the BotFather bot — he's the official Telegram bot for creating and managing bots.

3. Type /newbot to create a new bot. Follow the instructions:

   • Choose a display name (e.g. My PVE Bot)
   • Choose a username — must be unique and end in bot (e.g. my_pve_bot)

4. BotFather will generate an API token (e.g. 707587383:AAHD9D***************).

5. Copy the token and paste it into the Token field in the Bots module settings.

Unique test usernames

If you are creating a bot just for testing, prefix the username with your name to make it unique (e.g. john_pve_bot).

Settings

Show all settings

Setting	Default	Purpose
Enabled	off	Master on/off switch for the module on the cluster
Telegram → Enabled	off	Enable the Telegram transport
Telegram → BOT API Token	–	Token generated by BotFather, stored encrypted at rest
Telegram → Chats Id	–	Newline-separated list of allowed chat IDs — leave empty to disable access control