2021-08-19 13:27:53 +00:00
# Learn how to use Fleet
2021-08-03 15:22:42 +00:00
2022-08-19 18:13:15 +00:00
- [How to add your device to Fleet ](#how-to-add-your-device-to-fleet )
- [How to ask questions about your device ](#how-to-ask-questions-about-your-device )
2021-08-03 15:22:42 +00:00
2022-08-19 18:13:15 +00:00
### Overview
2022-08-12 17:03:14 +00:00
2022-08-19 18:13:15 +00:00
In this guide, we'll cover the following concepts:
- How to add your device to Fleet
- How to ask questions about your device
2022-08-12 17:03:14 +00:00
2022-08-19 18:13:15 +00:00
### How to add your device to Fleet
2021-08-03 15:22:42 +00:00
2021-10-28 03:31:59 +00:00
Once you log into Fleet, you are presented with the **Home** page.
2022-08-19 18:13:15 +00:00
To add your device:
1. Select **Add hosts** . In Fleet, devices are referred to as "hosts."
2. Select your device's platform.
3. Select **Download** to download your Fleet osquery installer. The download may take several seconds.
4. Open the Fleet osquery installer and follow the installation steps.
2021-08-03 15:22:42 +00:00
2022-08-19 18:13:15 +00:00
> It may take several seconds for Fleet osquery to send your device's data to Fleet.
2021-08-03 15:22:42 +00:00
2021-10-28 03:31:59 +00:00
In the background, Fleet ran several checks to assess the security hygiene of your device.
2021-08-11 21:34:24 +00:00
2022-08-19 18:13:15 +00:00
> In Fleet, these checks are referred to as "policies."
2021-08-03 15:22:42 +00:00
2022-08-19 18:13:15 +00:00
### How to ask questions about your device
2021-08-19 13:27:53 +00:00
2022-08-19 18:13:15 +00:00
With Fleet, you can ask a multitude of questions to help you manage, monitor, and identify threats on your devices, but if you are just starting out, and unsure of what to ask, Fleet comes baked in with a [query library ](https://fleetdm.com/queries ) of common questions.
2021-08-19 13:27:53 +00:00
2021-10-28 03:31:59 +00:00
So, let's start by asking the following question about your device:
2021-08-03 15:22:42 +00:00
2022-08-19 18:13:15 +00:00
* What operating system is installed on my device and what is its version?
This question can easily be answered by running this simple query: "Get operating system information."
2021-08-03 15:22:42 +00:00
2022-08-19 18:13:15 +00:00
To run this query on your device:
2021-08-11 21:31:34 +00:00
2022-08-19 18:13:15 +00:00
1. Select **Queries** in the top navigation.
2023-02-13 15:45:37 +00:00
2. Select **Create new query** (or browse your organization's queries for "operating system information" in the search bar).
3. Type the query you would like to run, `SELECT * FROM os_version;` .
2022-08-19 18:13:15 +00:00
4. Select **Run query** , then select **All hosts** (your device may be the only host added to Fleet), and finally select **Run** to execute the query.
2021-08-11 21:34:24 +00:00
2023-02-13 15:45:37 +00:00
The query may take several seconds to complete, because Fleet has to wait for the osquery agents to respond with results. Only online hosts will respond with results to a live query.
2021-08-03 15:22:42 +00:00
> Fleet's query response time is inherently variable because of osquery's heartbeat response time. This helps prevent performance issues on hosts.
2021-10-28 03:31:59 +00:00
When the query has finished, you should see several columns in the "Results" table:
2021-08-19 13:27:53 +00:00
2022-08-19 18:13:15 +00:00
- The "name" column answers: "What operating system is installed on my device?"
2021-08-19 13:27:53 +00:00
2022-08-19 18:13:15 +00:00
- The "version" column answers: "What version of the installed operating system is on my device?"
2021-08-19 13:27:53 +00:00
2022-03-22 10:52:12 +00:00
< meta name = "pageOrderInSection" value = "100" >
2023-07-13 16:57:17 +00:00
< meta name = "description" value = "Get started with using Fleet by learning how to enroll your device into a Fleet instance and run queries to ask questions about it." >
2023-07-27 22:40:01 +00:00
< meta name = "navSection" value = "hidden" >
