Adding Plugins
Plugins are Ansible playbooks that define what gets installed and configured on each machine during the build. A Domain Controller plugin installs Active Directory, a vulnerability plugin plants an exploitable service, a file copy plugin moves files onto the machine — and so on.
Entering Machine Edit Mode
Section titled “Entering Machine Edit Mode”To manage plugins on a machine, double-click the machine node on the canvas. This enters machine edit mode, where:
- The left sidebar switches to show plugin categories
- The main panel shows the machine’s current plugin list (the build sequence)
- You can drag plugins from the sidebar into the build sequence
Plugin Categories
Section titled “Plugin Categories”Plugins are organized into categories in the sidebar:
| Category | Description |
|---|---|
| Actions | General configuration tasks (domain joins, user creation, network config) |
| Vulnerabilities | Deliberately vulnerable services and misconfigurations |
| Attack | Offensive tools and payloads |
| Defense | Defensive tools, monitoring, and hardening |
| Roles | System roles (Domain Controller, DNS Server, Web Server) |
| Apps | Applications and services |
| Copy Files | File transfer operations from your vault to the machine |
Adding a Plugin
Section titled “Adding a Plugin”- Browse plugin categories in the sidebar, or use the search
- Find the plugin you want
- Drag it from the sidebar onto the build sequence area
- The plugin appears in the machine’s build pipeline
After adding a plugin, the system may run auto-apply automations — these are plugin-level rules that can automatically fill in VLAN or machine configuration based on the plugin’s requirements.
Build Sequence Order
Section titled “Build Sequence Order”The build sequence determines the order plugins execute during a build. The order matters — for example, a Domain Controller plugin should run before a Domain Join plugin.
- Drag and drop plugins within the build sequence to reorder them
- A floating trash can appears during drag — drop a plugin on it to remove it
- The pipeline shows dependency relationships between plugins (parent → child)
Plugin Snapshots
Section titled “Plugin Snapshots”Each plugin in the build sequence has a snapshot toggle (camera icon). When enabled, the build system takes a VM snapshot before executing that plugin. If the plugin fails, you can revert to that snapshot and try again without rebuilding everything from scratch.
Copy Files
Section titled “Copy Files”The Copy Files feature lets you upload files to a machine’s vault and then copy them to specific paths during the build:
- Upload files and folders to the machine’s unique vault using the Manage Files button
- Drag the Copy Files control from the sidebar into the build sequence
- Click the copy files card to configure source and destination paths
This requires the Launch Builds permission to upload files.
Plugin Requests
Section titled “Plugin Requests”Can’t find a plugin for what you need? Use the Request a Plugin feature to submit a request to the Rogue Labs team. Describe what you need and the team will work on building it.