---
title: Charmhub | Deploy Charmscaler using Charmhub - The Open Operator Collection
description: Deploy the latest version of Charmscaler on any cloud.
url: https://charmhub.io/charmscaler/configurations
---

# Charmscaler

[Elastisys](https://charmhub.io/publisher/elastisys "View all packages from Elastisys")

* [Elastisys](https://charmhub.io/publisher/elastisys "View all packages from Elastisys")
* [Containers](https://charmhub.io/?filter=containers)
* [Monitoring](https://charmhub.io/?filter=monitoring)

Platform:

18.04

16.04

stable 2

```
juju deploy charmscaler
```

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

* [alert\_enabled](https://charmhub.io/charmscaler/configurations#alert_enabled)
* [alert\_levels](https://charmhub.io/charmscaler/configurations#alert_levels)
* [alert\_receivers](https://charmhub.io/charmscaler/configurations#alert_receivers)
* [alert\_sender](https://charmhub.io/charmscaler/configurations#alert_sender)
* [alert\_smtp\_host](https://charmhub.io/charmscaler/configurations#alert_smtp_host)
* [alert\_smtp\_password](https://charmhub.io/charmscaler/configurations#alert_smtp_password)
* [alert\_smtp\_port](https://charmhub.io/charmscaler/configurations#alert_smtp_port)
* [alert\_smtp\_ssl](https://charmhub.io/charmscaler/configurations#alert_smtp_ssl)
* [alert\_smtp\_username](https://charmhub.io/charmscaler/configurations#alert_smtp_username)
* [charmpool\_url](https://charmhub.io/charmscaler/configurations#charmpool_url)
* [docker-opts](https://charmhub.io/charmscaler/configurations#docker-opts)
* [enable-cgroups](https://charmhub.io/charmscaler/configurations#enable-cgroups)
* [http\_proxy](https://charmhub.io/charmscaler/configurations#http_proxy)
* [https\_proxy](https://charmhub.io/charmscaler/configurations#https_proxy)
* [install\_from\_upstream](https://charmhub.io/charmscaler/configurations#install_from_upstream)
* [juju\_api\_endpoint](https://charmhub.io/charmscaler/configurations#juju_api_endpoint)
* [juju\_model\_uuid](https://charmhub.io/charmscaler/configurations#juju_model_uuid)
* [juju\_password](https://charmhub.io/charmscaler/configurations#juju_password)
* [juju\_refresh\_interval](https://charmhub.io/charmscaler/configurations#juju_refresh_interval)
* [juju\_username](https://charmhub.io/charmscaler/configurations#juju_username)
* [metric\_data\_settling\_interval](https://charmhub.io/charmscaler/configurations#metric_data_settling_interval)
* [metric\_poll\_interval](https://charmhub.io/charmscaler/configurations#metric_poll_interval)
* [nagios\_context](https://charmhub.io/charmscaler/configurations#nagios_context)
* [nagios\_servicegroups](https://charmhub.io/charmscaler/configurations#nagios_servicegroups)
* [name](https://charmhub.io/charmscaler/configurations#name)
* [no\_proxy](https://charmhub.io/charmscaler/configurations#no_proxy)
* [port\_autoscaler](https://charmhub.io/charmscaler/configurations#port_autoscaler)
* [scaling\_cooldown](https://charmhub.io/charmscaler/configurations#scaling_cooldown)
* [scaling\_cpu\_max](https://charmhub.io/charmscaler/configurations#scaling_cpu_max)
* [scaling\_cpu\_min](https://charmhub.io/charmscaler/configurations#scaling_cpu_min)
* [scaling\_interval](https://charmhub.io/charmscaler/configurations#scaling_interval)
* [scaling\_period\_downscale](https://charmhub.io/charmscaler/configurations#scaling_period_downscale)
* [scaling\_period\_upscale](https://charmhub.io/charmscaler/configurations#scaling_period_upscale)
* [scaling\_units\_max](https://charmhub.io/charmscaler/configurations#scaling_units_max)
* [scaling\_units\_min](https://charmhub.io/charmscaler/configurations#scaling_units_min)

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

* alert\_enabled | boolean

  Toggle e-mail alerts on/off
* alert\_levels | string

  Default: INFO NOTICE WARN ERROR FATAL

  Alert levels that should trigger alert mails to be sent out
* alert\_receivers | string

  Space separated list of e-mail addresses that should recieve alerts
* alert\_sender | string

  E-mail address that alert mails should be sent from
* alert\_smtp\_host | string

  SMTP hostname
* alert\_smtp\_password | string

  Password to auth with the SMTP server
* alert\_smtp\_port | int

  Default: 25

  SMTP port
* alert\_smtp\_ssl | boolean

  Use SSL when connecting to SMTP host
* alert\_smtp\_username | string

  Username to auth with the SMTP server
* charmpool\_url | string

  Default: http://charmpool:80

  URL to the Charmpool component. By default both the autoscaler and the
  pool is run in the same Docker network and will reach eachother by their
  local hostnames.
* docker-opts | string

  Extra options to pass to the docker daemon. e.g. --insecure-registry
* enable-cgroups | boolean

  Enable GRUB cgroup overrides cgroup\_enable=memory swapaccount=1. WARNING
  changing this option will reboot the host - use with caution on production
  services
* http\_proxy | string

  URL to use for HTTP\_PROXY to be used by Docker. Only useful in closed
  environments where a proxy is the only option for routing to the
  registry to pull images
* https\_proxy | string

  URL to use for HTTPS\_PROXY to be used by Docker. Only useful in closed
  environments where a proxy is the only option for routing to the
  registry to pull images
* install\_from\_upstream | boolean

  Toggle installation from ubuntu archive vs the docker PPA
* juju\_api\_endpoint | string

  Juju controller API endpoint
* juju\_model\_uuid | string

  Juju model UUID
* juju\_password | string

  Juju account password
* juju\_refresh\_interval | int

  Default: 5

  How often the charmscaler should sync against the Juju model.
* juju\_username | string

  Juju account username
* metric\_data\_settling\_interval | int

  Default: 15

  The minimum age (in seconds) of requested data points. When requesting
  recent aggregate metric data points, there is always a risk of seeing
  partial/incomplete results before metric values from all sources have
  been registered. The value to set for this field depends on the reporting
  frequency of monitoring agents, but as a general rule-of-thumb, this
  value can be set to be about 1.5 times the length of the
  reporting-interval for monitoring agents.
* metric\_poll\_interval | int

  Default: 10

  Seconds between polls for new metric values
* nagios\_context | string

  Default: juju

  Used by the nrpe subordinate charms.
  A string that will be prepended to instance name to set the host name
  in nagios. So for instance the hostname would be something like:
  juju-myservice-0
  If you're running multiple environments with the same services in them
  this allows you to differentiate between them.
* nagios\_servicegroups | string

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

  Default: CharmScaler

  The name of the service - mainly shows up in the alert e-mails

  Also useful to distinguish between multiple CharmScaler charms
* no\_proxy | string

  Comma-separated list of destinations (either domain names or IP
  addresses) that should be directly accessed, by opposition of going
  through the proxy defined above.
* port\_autoscaler | int

  Default: 8097

  Port which the Autoscaler API should be served on.
* scaling\_cooldown | int

  Default: 300

  Time (in seconds) before making another scaling decision from the time of
  the last up- or downscale. This is useful to prevent extra resizes due to
  slow teardowns or, in perticular, upstarts.
* scaling\_cpu\_max | int

  Default: 80

  CPU usage threshold at which the number of units should be scaled up.
* scaling\_cpu\_min | int

  Default: 20

  CPU threshold where the load is considered low enough to scale down the
  number of units.
* scaling\_interval | int

  Default: 10

  Seconds between each scaling decision
* scaling\_period\_downscale | int

  Default: 120

  Number of seconds that the CPU usage needs to be lower than the threshold
  before scaling down.
* scaling\_period\_upscale | int

  Default: 60

  Number of seconds that the CPU usage needs to be higher than the
  threshold before scaling up.
* scaling\_units\_max | int

  Default: 4

  Maximum amount of units to keep in pool
* scaling\_units\_min | int

  Default: 1

  Minimum amount of units to keep in pool