The agent-native Illumio plugin framework. Manage PCE plugins as Docker containers. Python SDK, shared reporting bus (Slack/Teams/email/webhook), web dashboard, AI-assisted policy, and a plugin registry with 31 plugins.
Agent-native means plugger is built to be authored and operated by AI coding agents: Claude Code scaffolds plugins through the build-plugin skill, the dashboard, HTTP APIs and reporting bus are all drivable by an agent, and the Python SDK keeps a working plugin to roughly 50 lines.
plugger init && plugger install pce-health-monitor && plugger run
From a single command to a production-grade platform.
One command starts everything. Auto-restart on crash with exponential backoff, health checks, cron scheduling, and embedded dashboard.
Plugin tiles, live log streaming, config editing, dark/light theme. All plugin UIs consolidated under one port via reverse proxy.
Security posture scoring, policy suggestions, compliance mapping. Optional LLM integration with Anthropic, OpenAI, or Ollama for AI narratives and recommendations.
Search, install, and upgrade plugins by name. Official + custom registries. Browse in the dashboard or CLI. Multi-arch images on GHCR.
Plugins publish reports to a shared bus. Plugger routes to Slack, Microsoft Teams, email (SMTP with auth), or webhooks. Filters by severity, plugin, and tags. Scheduled email digests. Test messages from the dashboard.
Build plugins in ~50 lines with plugger_sdk.py. Decorators for polling, API routes, and dashboards. PCE connection, label cache, state management, and reporting built in. Custom registries for private plugins.
Auto-detects Docker (Desktop, Colima, Podman), reads PCE credentials from .env or environment, tests connectivity.
plugger init
From the registry by name, a URL, a local manifest file, or a container image reference.
plugger install ai-security-report
Starts all plugins with auto-restart, health checks, cron scheduling, event webhooks, and the web dashboard.
plugger run
Install with plugger install <name> · Click any plugin for full documentation
⚠️ Plugins marked preview (and example) may not have been tested against a live PCE or the target integration. Validate them in a non-production environment before relying on them.
Comprehensive security posture analysis. 10 categories, scoring, compliance mapping (NIST/CIS/PCI-DSS), environment heatmap, AI narratives, PDF export.
plugger install ai-security-report
Docs →
Policy advisor. Tiered rule generation (ringfencing/app-tiered/high-security), infrastructure detection, label gaps. One-click provisioning to PCE draft.
plugger install ai-assisted-rules
Docs →
Real-time PCE health dashboard. Checks health, node availability, CPU/memory/disk, and service status with color-coded indicators.
plugger install pce-health-monitor
Docs →
Interactive traffic flow analysis with Chart.js. Top talkers, blocked flows, policy decisions, Sankey diagram for source-service-destination.
plugger install traffic-reporter
Docs →
Git-like policy change tracker. Field-level diffs between draft and active, history snapshots, user attribution from audit events.
plugger install policy-diff
Docs →
Resolve label-based policy into IP-level firewall rules. Expand labels, label groups, IP lists to concrete IPs. JSON/TSV export per ruleset.
plugger install policy-resolver
Docs →
Real-time event monitoring. 15+ output plugins: Slack, Teams, PagerDuty, Email, webhooks, Jira, ServiceNow, Syslog.
plugger install pce-events
Docs →
Scheduled security posture scoring. Enforcement coverage, label coverage, policy rules. Generates HTML + JSON reports.
plugger install pce-posture-report
Docs →
Warns before PCE service accounts, pairing keys, license, or TLS certificate expire. Daily checks publish to the reporting bus.
plugger install pce-expiry-watch
Docs →
Discover offline, unresponsive, and trafficless workloads. Groups by app|env labels. Optional cleanup (unpair/delete).
plugger install stale-workloads
Docs →
Time-based rule and ruleset scheduling. Business hours, maintenance windows, weekend lockdowns. YAML config, immediate reconciliation.
plugger install rule-scheduler
Docs →
Sync Illumio workload labels to Palo Alto Dynamic Address Groups via PAN-OS XML API. Configurable tag format, dry-run mode.
plugger install palo-alto-dag-sync
Docs →
Discover AD computers via LDAP and map OU, group, location attributes to Illumio labels. Analytics mode for safe feasibility testing.
plugger install ad-label-sync
Docs →
Sync BMC Helix/Remedy CMDB CIs to Illumio labels. Maps business service, environment, location to labels. Analytics + sync modes.
plugger install remedy-cmdb-sync
Docs →
Sync Illumio workloads to ZTNA application definitions. Supports Zscaler ZPA, Netskope NPA, Cloudflare Access, Cisco Secure Access. Analytics + sync modes.
plugger install ztna-sync
Docs →
Bi-directional sync between Illumio PCE and Infoblox IPAM/DDI. Maps labels to extensible attributes and vice versa. Analytics + sync modes.
plugger install infoblox-ipam-sync
Docs →
Instant workload quarantine via webhook. Isolate compromised workloads, EDR/SOAR integration, auto-release TTL, full audit trail.
plugger install workload-isolator
Docs →
Fleet-level VEN visibility — enforcement progression pipeline, compatibility check tracking, version distribution, batch progression to visibility.
plugger install ven-fleet-manager
Docs →
Git-based policy management. Sync rulesets, IP lists, services, and label groups as YAML between a Git repo and the PCE. Push/pull workflows with drift detection.
Approval-based policy workflow engine. Multi-stage approval pipelines, Slack/Teams notifications, and audit logging for policy changes. Integrates with Policy GitOps.
Dependency intelligence beyond policy — blast radius, SPOF detection, compliance boundaries, change impact analysis, D3.js dependency graph.
plugger install app-dependency-intel
Docs →
Sync Illumio workloads to FortiGate via RSSO auth table and/or REST API address objects. Multi-group support, based on illumio-to-fortigate-sync by ruckle-o.
plugger install fortigate-sync
Docs →
Import VMware VMs as unmanaged workloads with labels from vCenter tags and folder hierarchy. Push Illumio labels back as vCenter tags. Analytics + sync modes.
plugger install vcenter-sync
Docs →
Scan traffic for unknown IPs, reverse-DNS resolve hostnames, create unmanaged workloads. Subnet filtering, label inference from hostname patterns, dry-run mode.
plugger install network-discovery
Docs →
Import vulnerability scans into Illumio PCE vmaps. Supports Nessus, Qualys, Tenable file uploads and live API pulls. IP-to-workload matching, batch upload, import history.
plugger install vmaps-handler
Docs →
Snapshot PCE policy objects and workload inventory to versioned JSON backups, diff over time, and restore to draft policy with a guarded preview.
plugger install policy-backup
Docs →
Sync OT/ICS asset inventory from the Dragos Platform into Illumio as unmanaged workloads with labels for device type, zone, Purdue level, vendor, and criticality.
plugger install dragos-sync
Docs →
Sync OT/ICS/IoT asset inventory from Nozomi Networks (Vantage or Guardian) into Illumio as unmanaged workloads with labels for type, zone, Purdue level, vendor, and criticality.
plugger install nozomi-sync
Docs →
Imports Cisco Meraki clients into Illumio as labeled unmanaged workloads for visibility (IoT/BYOD/branch devices). Dry-run by default.
plugger install meraki-sync
Docs →
Mirrors Cisco ISE TrustSec context (SGT definitions and host IP-SGT mappings) into Illumio as labels and unmanaged workloads. Read-only on ISE, dry-run by default.
plugger install ise-sync
Docs →
Collect NetFlow/IPFIX/sFlow/text flows to the Illumio PCE with an ingestion-health dashboard and silent-exporter alerts — runs the FlowPilot collector, no FlowLink install.
plugger install flowpilot
Docs →
Recent releases and what shipped in each
splunk output type delivers reports to the Splunk HTTP Event Collector as structured events, with index/sourcetype routing, newline-delimited batch (digest) delivery, and tlsSkipVerify for self-signed lab HEC. Configurable via plugger output add --type splunk.tools/mock-hec/ for testing the Splunk output end-to-end without a real Splunk.close of closed channel panic that could take the daemon down on plugger reload.localhost connection-refused; it now dials IPv4 and accepts an --addr override.POST /api/reports/test/{name}).localStorage, same-origin), is framework-independent and idempotent, and can be disabled with Plugin(name, inject_theme=False).ghcr.io/illumio-community.NETFLOW_PORT etc., default 2055/4739/6343/514) — flowpilot 0.2.1.portEnv / hostPort — a plugin's metadata.yaml port can now publish on a fixed host port. portEnv makes the port operator-configurable (host==container, tracks the env var, defaults to port); hostPort pins a fixed number. Unset = auto-assign, unchanged for UI/API ports.official registry URL automatically instead of staying pinned to the old one./api/vulns/delete to remove vulnerability data from the PCE (scopes: this plugin's report, all reports, all definitions, or everything), with a confirm guard.STALE_ACTION — dragos-sync & nozomi-sync can now report, label (lifecycle=stale), or delete a workload when its asset leaves the leading system.AUTHORITATIVE to false (overriding the code), so imports weren't authoritative; now default true everywhere — a scan is the source of truth for its scanned IPs.PCE_TLS_SKIP_VERIFY./healthz reported healthy regardless of PCE state; now returns the real PCE status in the body (200 kept for liveness)./api/v1/assets) and Guardian/CMC (on-prem, NQL query=assets). Type→role, zone→loc, Purdue level→env, vendor & criticality as custom dimensions; idempotent via external_data_set; DRY_RUN + field-map tuning. previewplugger outdated shows how to upgrade one or all.SHA256SUMS.PYTHONUNBUFFERED so plugin logs are present and clean.pce_timeout/pce_port; reinstall-from-registry so version upgrades stick.plugger outdated now shows how to upgrade one or all.force option to refresh version tags from current source (used to correct legacy stale tags).PYTHONUNBUFFERED=1 is injected into every container so Python plugins stream logs in real time instead of buffering them.pce_timeout (120s) and pce_port; the earlier timeout fix only applied to brand-new configs, so existing installs kept hitting the slow events endpoint at the 30s default.plugger-vmaps-handler:0.2.2), not just :latest. The registry points at immutable version tags, so the registry, image, and installed version can never drift. CI auto-discovers and builds each plugin when its version is bumped.SHA256SUMS, and atomically replaces the running binary. Releases now ship a checksums file.SCANNER_TYPE: the file's format is sniffed from its content (XML root / CSV header). Nessus, Qualys, Tenable.sc, and Tenable.io are recognized.docker version sanity check. Fixed the stale PCE port default (8443 → 443).plugger upgrade (alias reinstall) now do a true reinstall: pull the image, re-read the manifest + metadata from it, and persist the new version — preserving env overrides and enabled state. Routed through the owning scheduler so updates stick (no restart race).plugger output add --type teams --webhook ...@app.poll, @app.api, @app.dashboardplugger repo addplugger output add/list/remove/test for Slack, email, and webhook channels with filters, dry-run, and header configurationFrom zero to advanced — a guided journey through building and operating with Plugger.
Everything you need to install, configure, operate, and extend Plugger.
Install, initialize, connect to your PCE, and run your first plugin in minutes.
Prerequisites, building from source, global config, Docker socket, .env files, data layout.
All commands: init, run, install, create, start, stop, search, upgrade, auth, repo, and more.
Build your own plugins: manifests, metadata, templates (Go/Shell/Python/JavaScript), health checks, web UI proxying.
Production deployment, systemd, auto-restart, health checks, API key authentication, monitoring, troubleshooting, backup.
Webhook endpoint, event plugins, pce-events integration, traffic watchers, ephemeral containers.
Full docs for every plugin. Click to expand or use the plugin cards above.
# Install $ git clone https://github.com/illumio-community/illumio-plugger.git $ cd illumio-plugger && make build # Setup (auto-detects Docker, reads .env) $ plugger init ✓ Docker socket: ~/.docker/run/docker.sock ✓ PCE is reachable # Browse and install plugins $ plugger search NAME VERSION MODE DESCRIPTION ai-security-report 0.1.0 daemon AI-powered security posture analysis... ai-assisted-rules 0.2.0 daemon Policy advisor — tiered rules... pce-health-monitor 0.1.0 daemon Real-time PCE health dashboard... traffic-reporter 0.1.0 daemon Interactive traffic flow analysis... rule-scheduler 0.1.0 daemon Time-based rule scheduling... $ plugger install ai-security-report $ plugger install pce-health-monitor # Start everything $ plugger run Plugger running: 2 plugin(s) active Dashboard: http://localhost:8800
Scaffold a new plugin in Go, Shell, or Python. Runs as a Docker container with automatic PCE credential injection.
plugger create my-plugin -t go
plugger create my-plugin -t shell
plugger create my-plugin -t python
plugger create my-plugin -t javascript