Plugins

The agent image does not ship providers. The catalog is the same as the Marketplace tab in the local UI and in the WaveGrid console: the agent downloads a wheel with its tenant token, then you add a YAML section.

Installable today: Proxmox, Prometheus, SpaceWeb, Cloudflare, Hetzner Cloud, REG.RU, REG.RU Cloud, VK Cloud, Selectel, Miran, Yandex Cloud, and Cloud.ru. AWS has a catalog page (the wheel publishes as it ships). Other cards are coming soon.

Available

Plugin	Category	Collects
Proxmox VE	Virtualization	Nodes, VMs, LXC, storage
Prometheus	Monitoring	Scrape targets as servers and domains
SpaceWeb	Cloud / hosting	VPS, domains, DNS
Cloudflare	DNS	Zones, DNS, R2/KV, D1/Hyperdrive, load balancers
Hetzner Cloud	Cloud	Servers, volumes, LBs, IPs, networks, firewalls, certificates
REG.RU	Cloud / registrar	Domains, DNS, hosting, VPS
REG.RU Cloud	Cloud	cloud.reg.ru reglets, extra IPs, private networks
VK Cloud	Cloud	Servers, disks, networks, floating IPs, security groups, load balancers
Selectel	Cloud	Instances, dedicated servers, disks, networks, floating IPs, security groups, load balancers
Miran	Cloud / datacenter	Dedicated servers, VDS, domains, hosting, colocation, IPs
Yandex Cloud	Cloud	Virtual machines, disks, networks, public IPs, security groups, load balancers
Cloud.ru	Cloud	Evolution virtual machines, disks, subnets, VPCs, public IPs, security groups, load balancers
Amazon Web Services	Cloud	Compute, DBs, load balancers, storage

Provider fields come from the plugin schema in the local UI after Install.

Coming soon

The wheel is not published yet. In Marketplace Install stays disabled; the page describes what will ship.

Plugin	Category	Planned collect
DigitalOcean	Cloud	Droplets, volumes, LBs
Google Cloud	Cloud	Compute, SQL, load balancers
Microsoft Azure	Cloud	VMs, disks, LBs
Kubernetes	Orchestration	Cluster nodes and workloads

Install

After the agent is connected and can reach the API:

# Docker
docker compose exec agent wg-flow-agent plugin marketplace list
docker compose exec agent wg-flow-agent plugin install proxmox
docker compose exec agent wg-flow-agent plugin install prometheus
docker compose exec agent wg-flow-agent plugin install sweb
docker compose exec agent wg-flow-agent plugin install cloudflare
docker compose exec agent wg-flow-agent plugin install hetzner
docker compose exec agent wg-flow-agent plugin install regru
docker compose exec agent wg-flow-agent plugin install regcloud
docker compose exec agent wg-flow-agent plugin install vkcloud
docker compose exec agent wg-flow-agent plugin install selectel
docker compose exec agent wg-flow-agent plugin install miran
docker compose exec agent wg-flow-agent plugin install yandex
docker compose exec agent wg-flow-agent plugin install cloudru
docker compose exec agent wg-flow-agent plugin list

# pip / host
wg-flow-agent plugin marketplace list
wg-flow-agent plugin install proxmox

Same from the local UI: Marketplace → Install.

Wheels land in ~/.wg-flow-agent/plugins (in the container: /var/lib/wg-flow-agent/plugins, volume agent_data).

Update: wg-flow-agent plugin update proxmox. Remove: plugin uninstall.

Enable in YAML

After install, add plugins.<name>. Provider fields are on that plugin’s page. Minimal skeleton:

plugins:
  proxmox:
    enabled: true
    sources:
      - id: dc1
        provider_account: "proxmox-dc1"
        sync_interval_seconds: 300
        # API fields — see the plugin page

Multiple sources means multiple accounts of the same provider. Inventory distinguishes them by provider_account.

The local UI renders the form after install (schema from the marketplace).

Schedule

Each source has its own sync_interval_seconds (minimum 300). Sources that are due in the same tick are coalesced into one POST /sync/. If none are due, the scheduler still sends an empty heartbeat so the agent does not go offline.