From afc8bdd093929057a3ce01a626f6963a75f71f9e Mon Sep 17 00:00:00 2001 From: eashaw Date: Tue, 5 Oct 2021 07:28:52 -0500 Subject: [PATCH] Update instructions in Enroll your own device (#2364) --- .../00-Learn-how-to-use-Fleet.md | 22 ++++++------------- 1 file changed, 7 insertions(+), 15 deletions(-) diff --git a/docs/01-Using-Fleet/00-Learn-how-to-use-Fleet.md b/docs/01-Using-Fleet/00-Learn-how-to-use-Fleet.md index 36926ca4f2..5db5d381ff 100644 --- a/docs/01-Using-Fleet/00-Learn-how-to-use-Fleet.md +++ b/docs/01-Using-Fleet/00-Learn-how-to-use-Fleet.md @@ -84,31 +84,23 @@ Do any of the simulated, Linux hosts have a high severity vulnerable version of ### How to enroll your own device -To add your own device to Fleet, you'll first need to install the osquery agent. In this tutorial, we'll be using [Orbit](https://github.com/fleetdm/orbit), the recommended agent for Fleet. +To add your own device to Fleet, you'll first need to install the osquery agent. In this tutorial, we'll be using fleetctl package, the recommended agent for Fleet. -1. Make a clone of [Orbit's GitHub repository](https://github.com/fleetdm/orbit). - - > Take note on where your new Orbit directory is located on you device. Knowing this will be helpful when building the Orbit package in step 3. - - ![Clone Orbit repository](https://user-images.githubusercontent.com/78363703/133367260-d78d1e11-b8a9-4c36-a39b-b11b2f4d1197.png) - -2. In Fleet UI's Host page, hit the "Add new host" button, and copy your Fleet enroll secret (you'll need this in the next step.) +1. In Fleet UI's Host page, hit the "Add new host" button, and copy your Fleet enroll secret (you'll need this in the next step.) ![Add new host](https://user-images.githubusercontent.com/78363703/130040559-9eb77221-aeba-45ce-8f8a-fb1913d3843b.png) -3. With [fleetctl preview](http://fleetdm.com/get-started) still running, and [Go](https://golang.org/doc/install) 1.16 installed, run the following command (remembering to swap ```YOUR_FLEET_ENROLL_SECRET_HERE``` for the one you copied in the previous step: +2. With [fleetctl preview](http://fleetdm.com/get-started) still running, run the following command (remembering to swap ```YOUR_FLEET_ENROLL_SECRET_HERE``` for the one you copied in the previous step): ``` - # From within the top-level directory of your cloned Orbit repository… - # Generate a macOS installer pointed at your local Fleet - go run ./cmd/package --type=pkg --fleet-url=localhost:8412 --insecure --enroll-secret=YOUR_FLEET_ENROLL_SECRET_HERE + fleetctl package --type=pkg --fleet-url=https://localhost:8412 + --enroll-secret=YOUR_FLEET_ENROLL_SECRET_HERE ``` - > If you'd like to build a Windows package, set `--type=msi` in the above command. If you'd like to build a Linux package, set `--type=deb` (Debian, Ubuntu, etc.) or `--type=rpm` (RHEL, CentOS, etc.) in the above command. - A package configured to point at your Fleet instance has now been generated in your local Orbit repository + A package configured to point at your Fleet instance has now been generated in your local repository -4. Navigate to your generated package (use ```open .``` from macOS commandline,) then double click on the package, and finally complete the installation walkthrough to enroll your device as a host in Fleet. +3. Navigate to your generated package (use ```open .``` from macOS commandline,) then double click on the package, and finally complete the installation walkthrough to enroll your device as a host in Fleet. > It may take several seconds (≈30s) for your device to enroll. Refresh Fleet UI, and you should now see your local device in your list of hosts.