---
title: Charmhub | Deploy Ballot Content Cache using Charmhub - The Open Operator Collection
description: Deploy the latest version of Ballot Content Cache on any cloud.
url: https://charmhub.io/ballot-content-cache/configurations
---

# Ballot Content Cache

[Benjamin Allot](https://charmhub.io/publisher/ballot "View all packages from Benjamin Allot")

* [Benjamin Allot](https://charmhub.io/publisher/ballot "View all packages from Benjamin Allot")
* [Monitoring](https://charmhub.io/?filter=monitoring)
* [Networking](https://charmhub.io/?filter=networking)

Platform:

20.04

18.04

stable 8

```
juju deploy ballot-content-cache
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

* [blacklist\_ports](https://charmhub.io/ballot-content-cache/configurations#blacklist_ports)
* [cache\_inactive\_time](https://charmhub.io/ballot-content-cache/configurations#cache_inactive_time)
* [cache\_max\_size](https://charmhub.io/ballot-content-cache/configurations#cache_max_size)
* [cache\_path](https://charmhub.io/ballot-content-cache/configurations#cache_path)
* [enable\_prometheus\_metrics](https://charmhub.io/ballot-content-cache/configurations#enable_prometheus_metrics)
* [log\_retention](https://charmhub.io/ballot-content-cache/configurations#log_retention)
* [max\_connections](https://charmhub.io/ballot-content-cache/configurations#max_connections)
* [nagios\_context](https://charmhub.io/ballot-content-cache/configurations#nagios_context)
* [nagios\_servicegroups](https://charmhub.io/ballot-content-cache/configurations#nagios_servicegroups)
* [sites](https://charmhub.io/ballot-content-cache/configurations#sites)
* [sites\_secrets](https://charmhub.io/ballot-content-cache/configurations#sites_secrets)
* [tls\_cipher\_suites](https://charmhub.io/ballot-content-cache/configurations#tls_cipher_suites)
* [worker\_connections](https://charmhub.io/ballot-content-cache/configurations#worker_connections)
* [worker\_processes](https://charmhub.io/ballot-content-cache/configurations#worker_processes)

[Learn about configurations >](https://juju.is/docs/juju/configuration#heading--application-configuration)

* blacklist\_ports | string

  Comma-separated list of TCP port numbers to skip over when generating internal servers used between haproxy and nginx. Used when a large number of sites may interfere with existing unit services, subordinate charms, etc.
* cache\_inactive\_time | string

  Maximum age/time inactive objects are stored in cache. If unspecified, use the upstream defaults (currently 10m).
* cache\_max\_size | string

  Maximum size of content cache storage. If unspecified, the maximum cache storage size will be set to 75% of the total disk space, using a 1GB minimum size.
* cache\_path | string

  Default: /var/lib/nginx/proxy

  Path or directory to store cached objects.
* enable\_prometheus\_metrics | boolean

  Default: True

  Export metrics for the number of requests and the number of cache hits. Prometheus metrics are exposed at /metrics on port 9145.
* log\_retention | int

  Default: 30

  Number of log files to retain during rotation.
* max\_connections | int

  Configure maximum number of connections per site on frontend HAProxy. Defaults to auto-calculate (0).
* nagios\_context | string

  Default: juju

  This string is prefixed to the hostname when writing exported nagios config fragments.
* nagios\_servicegroups | string

  A comma-separated list of nagios servicegroups. If left empty, the nagios\_context will be used as the servicegroup
* sites | string

  YAML-formatted virtual hosts/sites. See the README.md for more details and examples.
* sites\_secrets | string

  YAML-formatted dictionary of secrets/keys. e.g. site1.local:
  locations:
  "/":
  origin-headers:
  X-Origin-Key: my-origin-secret-key
  signed-url-hmac-key: my-signed-url-secret-key
* tls\_cipher\_suites | string

  Override default ciphers used for TLS/SSL termination (OpenSSL format).
* worker\_connections | int

  Default: 768

  Sets the maximum number of simultaneous connections that can be opened by an Nginx worker process.
* worker\_processes | int

  Sets the number of Nginx worker processes. Setting to '0' (auto) will set based on available CPU cores.