# Content Cache Operators

> Documentation for the Content Cache charms, Juju operators that deploy and manage a static web content cache with NGINX on virtual machines.


2026

## Pages

- [Content cache operators](https://canonical.com/juju/docs/content-cache-charms/latest/index.html.md): Discover the content cache charm, a Juju operator that deploys and manages NGINX.
- [Tutorial](https://canonical.com/juju/docs/content-cache-charms/latest/tutorial/index.html.md): Follow step-by-step tutorials to get started with the Content Cache Operators.
- [Deploy and configure the Content Cache charm](https://canonical.com/juju/docs/content-cache-charms/latest/tutorial/deploy-with-ingress-configurator-and-haproxy/index.html.md): Deploy content-cache behind ingress-configurator and haproxy to get hostname-based routing, TLS termination, and other ingress features.
- [How-to guides](https://canonical.com/juju/docs/content-cache-charms/latest/how-to/index.html.md): How-to guides for operating the Content Cache Operators, including basic operations, upgrades, and deployments.
- [How to connect to HTTPS backends](https://canonical.com/juju/docs/content-cache-charms/latest/how-to/enable-https/index.html.md): The Content Cache charm can proxy to backends over HTTPS. Backends are configured through the
- [How to hash client IP addresses in logs](https://canonical.com/juju/docs/content-cache-charms/latest/how-to/hash-client-ip-addresses-in-logs/index.html.md): Learn how to enable salted hashing of client IP addresses in the Content Cache charm access logs.
- [How to enable COS](https://canonical.com/juju/docs/content-cache-charms/latest/how-to/enable-cos/index.html.md): The charm utilizes Nginx as a static web content cache.
- [How to upgrade](https://canonical.com/juju/docs/content-cache-charms/latest/how-to/upgrade/index.html.md): Upgrade the `content-cache` charm with the `refresh` command:
- [How to contribute](https://canonical.com/juju/docs/content-cache-charms/latest/how-to/contribute/index.html.md): Familiarize yourself with contributing to the Content Cache Operators documentation.
- [Reference](https://canonical.com/juju/docs/content-cache-charms/latest/reference/index.html.md): Technical reference documentation for the Content Cache Operators, including a description of the components.
- [Intended deployment architecture](https://canonical.com/juju/docs/content-cache-charms/latest/reference/deployment-architecture/index.html.md): Reference for the intended deployment architecture of the Content Cache charm: required components, supported relations, and how they combine to support common use cases.
- [Components](https://canonical.com/juju/docs/content-cache-charms/latest/reference/components/index.html.md): A list of all components (charms) in the Content Cache operators project.
- [Explanation](https://canonical.com/juju/docs/content-cache-charms/latest/explanation/index.html.md): Explanation of the Content Cache Operators design, architecture, and security.
- [Caching behavior](https://canonical.com/juju/docs/content-cache-charms/latest/explanation/caching-behavior/index.html.md): Explanation of how the Content Cache charm caches static content, including cache miss and hit flow, expiry, eviction, and large-file considerations.
- [Charm design and how it works under the hood](https://canonical.com/juju/docs/content-cache-charms/latest/explanation/charm-design/index.html.md): Explanation of the Content Cache charm's design decisions and how they affect caching behavior, memory usage, failover, and backend protocols.
- [Security](https://canonical.com/juju/docs/content-cache-charms/latest/explanation/security/index.html.md): Explanation of the security design decisions in the Content Cache charm, including TLS, backend authentication, access control, and cached data risks.
- [Changelog](https://canonical.com/juju/docs/content-cache-charms/latest/changelog/index.html.md): All notable changes to this project will be documented in this file.