Groups & Virtual Modules

Host groups organize your infrastructure logically. You can group hosts across modules and display them as virtual modules in the navigation.

Managing Groups

Access group management via the Groups navigation item.

Creating a Group

1. Click Create Group
2. Configure the group:

Field	Description
Name	Name of the group
Description	Purpose of the group
Color	Color code for display
Customer	Optional: Restrict to a specific customer

Colors

Groups are displayed as colored chips/badges in the host tables. Choose a distinctive color to visually differentiate groups.

Assigning Hosts

Single Assignment

1. Open a host in the detail modal
2. Select the Groups tab
3. Click Assign Group
4. Select one or more groups

Bulk Assignment

1. Select multiple hosts using the checkboxes
2. Click Assign Group in the bulk action bar
3. Select the target group

Display in Tables

In the host tables, the Groups column shows colored chips with the assigned groups. The colors make group memberships recognizable at a glance.

Virtual Modules

Virtual modules are special groups that appear as their own tab in the main navigation.

Creating a Virtual Module

1. Create a group (as described above)
2. Enable the option Show as Virtual Module
3. The group appears as a new tab in the navigation

Use Cases

Virtual modules are ideal for:

• Location-based views - e.g., "Data Center North", "Branch Office South"
• Project groups - e.g., "Migration Project", "Test Environment"
• Customer dashboards - All hosts of a customer across modules
• Critical systems - Collection of all important hosts

Feature Set

Virtual modules offer the same features as regular modules:

• Host table with search and filter functionality
• Context menu actions
• Bulk operations

The difference: A virtual module displays hosts from different modules in a single table.

Filtering by Group

In the host tables, you can filter by group:

• Click on a group chip to show only hosts of that group
• Or use the group filter in the toolbar

Practical Examples

Location-Based Organization

Group "Location Berlin"       → Color: Blue
  ├── fw-berlin (OPNsense)
  ├── pve01-berlin (PVE)
  ├── backup-berlin (PBS)
  └── web-berlin (Linux)

Group "Location Munich"       → Color: Green
  ├── fw-munich (OPNsense)
  ├── pve01-munich (PVE)
  └── db-munich (Linux)

Maintenance Windows

Group "Maintenance Tuesday"   → Color: Orange
  ├── All hosts with Tuesday update schedule
  └── Script execution on the entire group