Proxmox

Proxmox VE runs virtual machines and containers. This shows VMs, containers, CPU, memory and nodes.

Set it up

Sign-in: An API key, sent in a header.

config.yaml

integrations:
  proxmox:
    type: proxmox
    url: http://proxmox:8080
    key: ${PROXMOX_KEY}

layout:
  - title: Infrastructure
    widgets:
      - proxmox.status

Option	Type	Default	What it does
url	URL	required	Where the service answers, from Valet’s side.
href	string	optional	Where the card links to, when that differs from url.
every	string or number	optional	How often to refresh while someone is looking: seconds, or 30s, 5m, 1h.
insecure	boolean	optional	Accept a self-signed certificate for this service only.
key	string	required	Its API key or token. Use ${VAR}, so it stays out of the file.
node	string	optional	one node, or just one VM or container
vmid	number	optional	one node, or just one VM or container

Widgets

One widget. Its key is proxmox.status, using the instance name from your config.

Proxmox

proxmox.status · stats card · refreshes every minute while the page is open.

Small

Wide

Medium

Large

In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

States

Can't reach it

Assistant tools

What the assistant can use, once its access level allows it. Read tools run freely. Everything else asks first.

Tool	Access	What it does
proxmox_status	read	What Proxmox reports right now: VMs, Containers, CPU, Memory, Nodes.

Year in review

Slides this integration adds to the recap.

Proxmox is running 4 machines