Skip to content
CorsinvestCorsinvestcv4pve-botgram
Prefer a web interface with scheduled runs? cv4pve-botgram also runs inside cv4pve-admin →
# install (x64; arm64 on the Releases page)
$ wget https://github.com/Corsinvest/\
cv4pve-botgram/releases/latest/download/\
cv4pve-botgram-linux-x64.zip
$ unzip cv4pve-botgram-linux-x64.zip
$ chmod +x cv4pve-botgram

# run against any node
$ ./cv4pve-botgram --host=pve01 \
    --api-token='bot@pve!bot=…' \
    --token='<telegram-bot-token>' \
    --chatsId=<chat-id>
Start listening

Manage your Proxmox VE cluster from Telegram

Runs outside the nodes, API only. Start, stop and shut down VMs and containers, reboot nodes and call any API path from a chat on your phone, restricted to the chats you allow.
Get startedSee the commands
cv4pve-botgram --host=pve01 --api-token='bot@pve!bot=…' --token='<telegram-bot-token>' --chatsId=<chat-id>

Then, in the chat with your bot:

You   /vmstart
Bot   Choose Vm
      [ qemu/100 web01 ]  [ lxc/105 dns ]
You   (tap "qemu/100 web01")
Bot   VM/CT qemu/100 on node pve01 Start!

Why

Section titled “Why”

A VM hangs at night, or a node needs a reboot while you are away from your desk. The Proxmox VE web interface is behind the company network: reaching it means a VPN and a laptop.

cv4pve-botgram puts the actions you need in those moments in a Telegram chat. The bot runs inside your network, next to the cluster, and you talk to it from the phone you already carry. It connects out to Telegram and waits for your messages: no port has to be opened towards your network.

Outside the nodes, API only

Section titled “Outside the nodes, API only”

cv4pve-botgram runs outside the cluster (on a management VM, a small server, a container) and talks only to the Proxmox VE REST API. Nothing is installed on the nodes and no SSH or root shell is needed: an API token with the privileges listed in Permissions is enough. Give it more than one node and it connects to the first one that answers, so it still works while a node is down.

What a chat can do is exactly what the token is allowed to do: a token that can only start and stop guests makes a bot that can only start and stop guests.

Prefer a web interface? cv4pve-admin runs the same bot as its Bots module, configured from the browser.

What it does for you

Section titled “What it does for you”
01

VMs and containers

Start, stop, shut down and reset: the bot lists the guests as buttons, grouped by node, and you tap the one you want.

02

Nodes

Reboot or shut down a node, chosen from the nodes that are online.

03

Any API call

get, set, create and delete on any path of the Proxmox VE API. Leave a placeholder in the path and the bot asks for it with buttons.

04

Aliases

Short names for the calls you repeat, such as /qsts for the status of a VM. Many are built in, and you add your own from the chat.

05

Only your chats

The bot answers only the chat IDs you list. Any other chat is refused and written to the log.

06

Runs as a service

One self-contained binary for Linux, Windows and macOS: a native systemd and Windows service, with no wrapper.

Part of the cv4pve suite →

Start your bot

Create the bot in Telegram, download the binary, point it at any node.

ProxmoxMade by Corsinvest,
official Proxmox partner
Get startedProfessional support