# osquery operator > This is the documentation for the osquery operator, a Juju charm deploying and managing osquery on virtual machines and bare-metal hosts. 2026 ## Pages - [osquery operator](https://canonical.com/juju/docs/osquery-charm/latest/index.html.md): Discover the osquery charm, a Juju operator that deploys and manages the osquery endpoint security monitoring agent. - [Tutorial](https://canonical.com/juju/docs/osquery-charm/latest/tutorial/index.html.md): Follow step-by-step tutorials to deploy and operate the osquery charm. - [Deploy the osquery charm for the first time](https://canonical.com/juju/docs/osquery-charm/latest/tutorial/basic-deployment/index.html.md): Deploy the osquery charm for the first time and relate it to a principal application. - [Connect the osquery agent to a controller](https://canonical.com/juju/docs/osquery-charm/latest/tutorial/advanced-deployment/index.html.md): Connect the osquery agent to an osquery controller using Juju configuration and secrets. - [How-to guides](https://canonical.com/juju/docs/osquery-charm/latest/how-to/index.html.md): How-to guides for operating the osquery charm, including basic operations, upgrades, and development. - [How to enroll the agent with a controller](https://canonical.com/juju/docs/osquery-charm/latest/how-to/enroll-with-controller/index.html.md): Provision an environment on an osquery controller and enroll the agent, including obtaining and rotating enrollment secrets and TLS certificates. - [How to troubleshoot](https://canonical.com/juju/docs/osquery-charm/latest/how-to/troubleshoot/index.html.md): Troubleshoot common issues with the osquery charm. - [How to back up and restore](https://canonical.com/juju/docs/osquery-charm/latest/how-to/back-up-restore/index.html.md): Learn why the osquery charm needs no data backup, and how to back up and restore its configuration. - [How to redeploy](https://canonical.com/juju/docs/osquery-charm/latest/how-to/redeploy/index.html.md): Learn how to redeploy the osquery charm. - [How to upgrade](https://canonical.com/juju/docs/osquery-charm/latest/how-to/upgrade/index.html.md): Learn how to upgrade the osquery charm. - [How to deploy with Terraform](https://canonical.com/juju/docs/osquery-charm/latest/how-to/terraform/index.html.md): Learn how to deploy the osquery charm with Terraform. - [How to contribute](https://canonical.com/juju/docs/osquery-charm/latest/how-to/contribute/index.html.md): Familiarize yourself with contributing to the osquery charm documentation. - [Reference](https://canonical.com/juju/docs/osquery-charm/latest/reference/index.html.md): Technical reference documentation for the osquery charm, including configurations, relations, and architecture. - [Actions](https://canonical.com/juju/docs/osquery-charm/latest/reference/actions/index.html.md): Reference explaining that the osquery charm exposes no Juju actions. - [Configurations](https://canonical.com/juju/docs/osquery-charm/latest/reference/configurations/index.html.md): Reference documentation for the configuration options of the osquery charm. - [Relation endpoints](https://canonical.com/juju/docs/osquery-charm/latest/reference/relation-endpoints/index.html.md): Reference for the relation endpoints exposed by the osquery charm. - [Juju events](https://canonical.com/juju/docs/osquery-charm/latest/reference/juju-events/index.html.md): Reference documentation for all Juju events observed by the osquery charm. - [Metrics](https://canonical.com/juju/docs/osquery-charm/latest/reference/metrics/index.html.md): Reference for the metrics exposed by the osquery charm. - [Charm architecture](https://canonical.com/juju/docs/osquery-charm/latest/reference/charm-architecture/index.html.md): An overview of the osquery charm's architecture, modules, and reconcile flow. - [High-level deployment overview](https://canonical.com/juju/docs/osquery-charm/latest/reference/high-level-deployment/index.html.md): A high-level overview of a typical osquery charm deployment. - [The osquery controller](https://canonical.com/juju/docs/osquery-charm/latest/reference/osquery-controller/index.html.md): Reference for the osquery controller and how it relates to the osquery charm. - [Cryptographic overview](https://canonical.com/juju/docs/osquery-charm/latest/reference/cryptographic-overview/index.html.md): Reference for the cryptographic technology used by the osquery charm. - [Terraform](https://canonical.com/juju/docs/osquery-charm/latest/reference/terraform/index.html.md): Reference for the Terraform module shipped with the osquery charm. - [Changelog](https://canonical.com/juju/docs/osquery-charm/latest/changelog/index.html.md): View the changelog for the osquery charm, including all versions and changes. - [Explanation](https://canonical.com/juju/docs/osquery-charm/latest/explanation/index.html.md): Explanation and background material for the osquery charm, including design and security. - [Charm design](https://canonical.com/juju/docs/osquery-charm/latest/explanation/charm-design/index.html.md): An explanation of the design decisions behind the osquery charm. - [Security](https://canonical.com/juju/docs/osquery-charm/latest/explanation/security/index.html.md): A security overview of the osquery charm, including its threat model and best practices. - [Release notes](https://canonical.com/juju/docs/osquery-charm/latest/release-notes/index.html.md): Release notes for all versions of the osquery charm, including release policy and schedule.