Add instructions for running osquery agents to development docs. (#58)

Used same verbiage from osquery-in-a-box README (https://github.com/fleetdm/osquery-in-a-box#run-osquery).
2020-11-19 16:36:27 -08:00
parent 45dbcebeb4
commit d3d4f81530
1 changed files with 11 additions and 0 deletions
@@ -26,3 +26,14 @@ If you get an `undefined: Asset` error it is likely because you did not run `mak
 First, in the Fleet UI, navigate to the App Settings page under Admin. Then, in the "SMTP Options" section, enter any email address in the "Sender Address" field, set the "SMTP Server" to `localhost` on port `1025`, and set "Authentication Type" to `None`. Note that you may use any active or inactive sender address.

 Visit [locahost:8025](http://localhost:8025) to view Mailhog's admin interface which will display all emails sent using the simulated mail server.
+
+## Adding hosts for testing
+
+The `osquery` directory contains a docker-compose.yml and additional configuration files to start containerized osquery agents. 
+
+To start osquery, first retrieve the "Enroll Secret" from Fleet (by clicking the "Add New Host") button in the Fleet dashboard, or with `fleetctl get enroll-secret`).
+
+```
+cd tools/osquery
+ENROLL_SECRET=<copy from fleet> docker-compose up
+```