Labels in Fleet provide a powerful way to scope profiles to specific hosts. This guide will walk you through managing labels using the Fleet web UI. Labels can be created dynamically using queries or manually by selecting specific hosts. Dynamic labels are applied to hosts that match the query criteria, while manual labels are assigned to hosts you select.
To access and manage labels in Fleet:
Navigate to the Hosts page: Click on the "Hosts" tab in the main navigation menu.
Filter by labels: In the "Filter by…" drop-down menu, you will see options for "Platforms" (e.g., macOS, Windows, Linux) and "Labels."
You can add a new label, filter existing labels by name, or select a label from the list. Selecting a label filters the view only to show hosts with that label.
To add a new label:
To edit an existing label:
Fleet also provides a REST API to manage labels programmatically. The API allows you to add, update, retrieve, list, and delete labels. Find detailed documentation on Fleet's REST API here.
fleetctl
Fleet's command line tool, fleetctl
will also allow you to list and manage labels. While managing labels with fleetctl
is beyond the scope of this guide, you can list all labels using the following command:
fleetctl get labels
Learn more about
fleetctl
CLI.
Using labels in Fleet enhances your ability to effectively manage and scope profiles to specific hosts. Whether you prefer to manage labels through the web UI or programmatically via the REST API, Fleet provides the flexibility and control you need. For more information on using Fleet, please refer to the Fleet documentation and guides.