From 900dcaabf6f8f32750ede58fbded4b69661ceb6c Mon Sep 17 00:00:00 2001
From: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
Date: Wed, 19 Mar 2025 11:24:32 -0400
Subject: [PATCH] Enroll hosts guide (#27223)

Based on `customer-cisneros`'s feedback here:
https://github.com/fleetdm/fleet/issues/21595#issuecomment-2730806008
---
 articles/enroll-hosts.md | 11 +++++------
 website/config/routes.js |  2 +-
 2 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/articles/enroll-hosts.md b/articles/enroll-hosts.md
index a6962de088..fe5873d210 100644
--- a/articles/enroll-hosts.md
+++ b/articles/enroll-hosts.md
@@ -47,17 +47,16 @@ To generate Fleet's agent (fleetd) in Fleet UI:
 2. Select the tab for your desired platform (e.g. macOS).
 3. A CLI command with all necessary flags to generate an install package will be generated. Copy and run the command with [fleetctl](https://fleetdm.com/docs/using-fleet/fleetctl-cli) installed.
 
-### Enroll host to a specific team
+### Install fleetd
+
+You can use your tool of choice, like [Munki](https://www.munki.org/munki/) on macOS or a package manager ([APT](https://en.wikipedia.org/wiki/APT_(software)) or [DNF](https://en.wikipedia.org/wiki/DNF_(software))) on Linux, to install fleetd. 
+
+### Enroll hosts to a team
 
 With hosts segmented into teams, you can apply unique queries and give users access to only the hosts in specific teams. [Learn more about teams](https://fleetdm.com/docs/using-fleet/segment-hosts).
 
 To enroll to a specific team: from the **Hosts** page, select the desired team from the menu at the top of the screen, then follow the instructions above for generating Fleet's agent (fleetd). The team's enroll secret will be included in the generated command.
 
-### Enroll multiple hosts
-
-If you're managing an enterprise environment with multiple hosts, you likely have an enterprise deployment tool like [Munki](https://www.munki.org/munki/), [Jamf Pro](https://www.jamf.com/products/jamf-pro/), [Chef](https://www.chef.io/), [Ansible](https://www.ansible.com/), or [Puppet](https://puppet.com/) to deliver software to your hosts.
-You can use your software management tool of choice to distribute Fleet's agent (fleetd) generated via the instructions above.
-
 ### Fleet Desktop
 
 [Fleet Desktop](https://fleetdm.com/guides/fleet-desktop) is a menu bar icon available on macOS, Windows, and Linux that gives your end users visibility into the security posture of their machine.
diff --git a/website/config/routes.js b/website/config/routes.js
index 7759a14cbf..d8eec5511c 100644
--- a/website/config/routes.js
+++ b/website/config/routes.js
@@ -575,7 +575,7 @@ module.exports.routes = {
   'GET /docs/deploy': '/docs/deploy/introduction',
   'GET /docs/using-fleet/faq': '/docs/get-started/faq',
   'GET /docs/using-fleet/monitoring-fleet': '/docs/deploy/monitoring-fleet',
-  'GET /docs/using-fleet/adding-hosts': '/docs/using-fleet/enroll-hosts',
+  'GET /docs/using-fleet/adding-hosts': '/docs/using-fleet/enroll-hosts#install-fleetd',
   'GET /docs/using-fleet/fleetd': '/docs/using-fleet/enroll-hosts',
   'GET /docs/using-fleet/teams': '/docs/using-fleet/segment-hosts',
   'GET /docs/using-fleet/permissions': '/docs/using-fleet/manage-access',