Installing osquery on Linux
A 'universal' Linux package can be created for each package distribution system. These packages contain the osquery daemon, shell, example configuration and startup scripts. Note that the /etc/init.d/osqueryd
script does not automatically start the daemon until a configuration file is created (see "Running osquery," below).
Each osquery tag (stable release) is published to yum and apt repositories for our supported operating systems: https://osquery.io/downloads.
The default packages create the following structure:
/etc/init.d/osqueryd
/etc/osquery/
/etc/sysconfig/osqueryd
/opt/osquery/bin/osqueryctl
/opt/osquery/bin/osqueryd
/usr/local/bin/osqueryi -> /opt/osquery/bin/osqueryd
/usr/local/bin/osqueryctl -> /opt/osquery/bin/osqueryctl
/usr/lib/systemd/system/osqueryd.service
/opt/osquery/share/osquery/certs/certs.pem
/opt/osquery/share/osquery/lenses/{*}.aug
/opt/osquery/share/osquery/packs/{*}.conf
/opt/osquery/share/osquery/osquery.example.conf
/var/log/osquery/
/var/osquery/
Installing osquery
To install osquery, follow the instructions on the Downloads page according to your distro.
NOTICE: Linux systems running
journald
will collect logging data originating from the kernel audit subsystem (something that osquery enables) from several sources, including audit records. To avoid performance problems on busy boxes (specially when osquery event tables are enabled), it is recommended to mask audit logs from entering the journal with the following commandsystemctl mask --now systemd-journald-audit.socket
.
Running osquery
To start a standalone osquery use: osqueryi
. This does not need an osquery server or service. All the table implementations are included!
After exploring the rest of the documentation you should understand the basics of configuration and logging. These and most other concepts apply to osqueryd
, the daemon, too. To start the daemon:
sudo cp /opt/osquery/share/osquery/osquery.example.conf /etc/osquery/osquery.conf
# sudo service osqueryd start
sudo systemctl start osqueryd
NOTICE: The interactive shell and daemon do NOT communicate!