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

# launchpad-librarian

[Canonical Launchpad Engineering](https://charmhub.io/publisher/launchpad "View all packages from Canonical Launchpad Engineering")

* [Canonical Launchpad Engineering](https://charmhub.io/publisher/launchpad "View all packages from Canonical Launchpad Engineering")

Platform:

20.04

stable 72ba15af7e0

```
juju deploy launchpad-librarian
```

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

* [active](https://charmhub.io/launchpad-librarian/configurations#active)
* [backfill\_sha512\_workers](https://charmhub.io/launchpad-librarian/configurations#backfill_sha512_workers)
* [blocked\_referers](https://charmhub.io/launchpad-librarian/configurations#blocked_referers)
* [blocked\_user\_agents](https://charmhub.io/launchpad-librarian/configurations#blocked_user_agents)
* [bounce\_address](https://charmhub.io/launchpad-librarian/configurations#bounce_address)
* [build\_label](https://charmhub.io/launchpad-librarian/configurations#build_label)
* [bzr\_imports\_root\_url](https://charmhub.io/launchpad-librarian/configurations#bzr_imports_root_url)
* [bzr\_lp\_prefix](https://charmhub.io/launchpad-librarian/configurations#bzr_lp_prefix)
* [bzr\_lp\_url\_hosts](https://charmhub.io/launchpad-librarian/configurations#bzr_lp_url_hosts)
* [candid\_service\_root](https://charmhub.io/launchpad-librarian/configurations#candid_service_root)
* [charmhub\_secrets\_public\_key](https://charmhub.io/launchpad-librarian/configurations#charmhub_secrets_public_key)
* [charmhub\_storage\_url](https://charmhub.io/launchpad-librarian/configurations#charmhub_storage_url)
* [charmhub\_url](https://charmhub.io/launchpad-librarian/configurations#charmhub_url)
* [cron\_control\_url](https://charmhub.io/launchpad-librarian/configurations#cron_control_url)
* [cron\_mailto](https://charmhub.io/launchpad-librarian/configurations#cron_mailto)
* [databases](https://charmhub.io/launchpad-librarian/configurations#databases)
* [db\_name](https://charmhub.io/launchpad-librarian/configurations#db_name)
* [db\_roles](https://charmhub.io/launchpad-librarian/configurations#db_roles)
* [db\_statement\_timeout](https://charmhub.io/launchpad-librarian/configurations#db_statement_timeout)
* [debuglog](https://charmhub.io/launchpad-librarian/configurations#debuglog)
* [default\_batch\_size](https://charmhub.io/launchpad-librarian/configurations#default_batch_size)
* [domain](https://charmhub.io/launchpad-librarian/configurations#domain)
* [domain\_bzr](https://charmhub.io/launchpad-librarian/configurations#domain_bzr)
* [domain\_git](https://charmhub.io/launchpad-librarian/configurations#domain_git)
* [domain\_librarian](https://charmhub.io/launchpad-librarian/configurations#domain_librarian)
* [domain\_librarian\_aliases](https://charmhub.io/launchpad-librarian/configurations#domain_librarian_aliases)
* [domain\_lists](https://charmhub.io/launchpad-librarian/configurations#domain_lists)
* [domain\_xmlrpc\_private](https://charmhub.io/launchpad-librarian/configurations#domain_xmlrpc_private)
* [env\_extra](https://charmhub.io/launchpad-librarian/configurations#env_extra)
* [environment](https://charmhub.io/launchpad-librarian/configurations#environment)
* [extra\_packages](https://charmhub.io/launchpad-librarian/configurations#extra_packages)
* [frontend\_proxy\_protocol\_enabled](https://charmhub.io/launchpad-librarian/configurations#frontend_proxy_protocol_enabled)
* [geoip\_database](https://charmhub.io/launchpad-librarian/configurations#geoip_database)
* [git\_loose\_objects\_threshold](https://charmhub.io/launchpad-librarian/configurations#git_loose_objects_threshold)
* [git\_packs\_threshold](https://charmhub.io/launchpad-librarian/configurations#git_packs_threshold)
* [gpg\_upload\_keys](https://charmhub.io/launchpad-librarian/configurations#gpg_upload_keys)
* [haproxy\_server\_options](https://charmhub.io/launchpad-librarian/configurations#haproxy_server_options)
* [haproxy\_service\_options\_download](https://charmhub.io/launchpad-librarian/configurations#haproxy_service_options_download)
* [haproxy\_service\_options\_upload](https://charmhub.io/launchpad-librarian/configurations#haproxy_service_options_upload)
* [http\_proxy](https://charmhub.io/launchpad-librarian/configurations#http_proxy)
* [install\_keys](https://charmhub.io/launchpad-librarian/configurations#install_keys)
* [install\_sources](https://charmhub.io/launchpad-librarian/configurations#install_sources)
* [internal\_bzr\_api\_endpoint](https://charmhub.io/launchpad-librarian/configurations#internal_bzr_api_endpoint)
* [internal\_git\_api\_endpoint](https://charmhub.io/launchpad-librarian/configurations#internal_git_api_endpoint)
* [is\_demo](https://charmhub.io/launchpad-librarian/configurations#is_demo)
* [librarian\_download\_host](https://charmhub.io/launchpad-librarian/configurations#librarian_download_host)
* [librarian\_download\_port](https://charmhub.io/launchpad-librarian/configurations#librarian_download_port)
* [librarian\_download\_url](https://charmhub.io/launchpad-librarian/configurations#librarian_download_url)
* [librarian\_restricted\_download\_host](https://charmhub.io/launchpad-librarian/configurations#librarian_restricted_download_host)
* [librarian\_restricted\_download\_port](https://charmhub.io/launchpad-librarian/configurations#librarian_restricted_download_port)
* [librarian\_restricted\_download\_url](https://charmhub.io/launchpad-librarian/configurations#librarian_restricted_download_url)
* [librarian\_restricted\_upload\_host](https://charmhub.io/launchpad-librarian/configurations#librarian_restricted_upload_host)
* [librarian\_restricted\_upload\_port](https://charmhub.io/launchpad-librarian/configurations#librarian_restricted_upload_port)
* [librarian\_upload\_host](https://charmhub.io/launchpad-librarian/configurations#librarian_upload_host)
* [librarian\_upload\_port](https://charmhub.io/launchpad-librarian/configurations#librarian_upload_port)
* [log\_hosts\_allow](https://charmhub.io/launchpad-librarian/configurations#log_hosts_allow)
* [mailman\_shared\_secret](https://charmhub.io/launchpad-librarian/configurations#mailman_shared_secret)
* [nagios\_context](https://charmhub.io/launchpad-librarian/configurations#nagios_context)
* [nagios\_servicegroups](https://charmhub.io/launchpad-librarian/configurations#nagios_servicegroups)
* [oci\_registry\_credentials\_public\_key](https://charmhub.io/launchpad-librarian/configurations#oci_registry_credentials_public_key)
* [old\_os\_auth\_url](https://charmhub.io/launchpad-librarian/configurations#old_os_auth_url)
* [old\_os\_auth\_version](https://charmhub.io/launchpad-librarian/configurations#old_os_auth_version)
* [old\_os\_password](https://charmhub.io/launchpad-librarian/configurations#old_os_password)
* [old\_os\_tenant\_name](https://charmhub.io/launchpad-librarian/configurations#old_os_tenant_name)
* [old\_os\_username](https://charmhub.io/launchpad-librarian/configurations#old_os_username)
* [oops\_prefix](https://charmhub.io/launchpad-librarian/configurations#oops_prefix)
* [oops\_rabbitmq\_broker\_urls](https://charmhub.io/launchpad-librarian/configurations#oops_rabbitmq_broker_urls)
* [oops\_rabbitmq\_user](https://charmhub.io/launchpad-librarian/configurations#oops_rabbitmq_user)
* [openid\_alternate\_provider\_roots](https://charmhub.io/launchpad-librarian/configurations#openid_alternate_provider_roots)
* [openid\_provider\_root](https://charmhub.io/launchpad-librarian/configurations#openid_provider_root)
* [os\_auth\_url](https://charmhub.io/launchpad-librarian/configurations#os_auth_url)
* [os\_auth\_version](https://charmhub.io/launchpad-librarian/configurations#os_auth_version)
* [os\_password](https://charmhub.io/launchpad-librarian/configurations#os_password)
* [os\_tenant\_name](https://charmhub.io/launchpad-librarian/configurations#os_tenant_name)
* [os\_username](https://charmhub.io/launchpad-librarian/configurations#os_username)
* [package\_status](https://charmhub.io/launchpad-librarian/configurations#package_status)
* [port\_download\_base](https://charmhub.io/launchpad-librarian/configurations#port_download_base)
* [port\_restricted\_download\_base](https://charmhub.io/launchpad-librarian/configurations#port_restricted_download_base)
* [port\_restricted\_upload\_base](https://charmhub.io/launchpad-librarian/configurations#port_restricted_upload_base)
* [port\_upload\_base](https://charmhub.io/launchpad-librarian/configurations#port_upload_base)
* [port\_xmlrpc](https://charmhub.io/launchpad-librarian/configurations#port_xmlrpc)
* [ppa\_base\_url](https://charmhub.io/launchpad-librarian/configurations#ppa_base_url)
* [ppa\_private\_base\_url](https://charmhub.io/launchpad-librarian/configurations#ppa_private_base_url)
* [profile\_dir](https://charmhub.io/launchpad-librarian/configurations#profile_dir)
* [rabbitmq\_broker\_urls](https://charmhub.io/launchpad-librarian/configurations#rabbitmq_broker_urls)
* [rabbitmq\_user](https://charmhub.io/launchpad-librarian/configurations#rabbitmq_user)
* [restricted\_librarian\_abuse\_mitigation](https://charmhub.io/launchpad-librarian/configurations#restricted_librarian_abuse_mitigation)
* [send\_email](https://charmhub.io/launchpad-librarian/configurations#send_email)
* [sentry\_dsn](https://charmhub.io/launchpad-librarian/configurations#sentry_dsn)
* [session\_cookie\_name](https://charmhub.io/launchpad-librarian/configurations#session_cookie_name)
* [site\_message](https://charmhub.io/launchpad-librarian/configurations#site_message)
* [slow\_query\_timeout](https://charmhub.io/launchpad-librarian/configurations#slow_query_timeout)
* [snap\_store\_secrets\_public\_key](https://charmhub.io/launchpad-librarian/configurations#snap_store_secrets_public_key)
* [snap\_store\_upload\_url](https://charmhub.io/launchpad-librarian/configurations#snap_store_upload_url)
* [snap\_store\_url](https://charmhub.io/launchpad-librarian/configurations#snap_store_url)
* [soft\_request\_timeout](https://charmhub.io/launchpad-librarian/configurations#soft_request_timeout)
* [ssl\_chain\_required](https://charmhub.io/launchpad-librarian/configurations#ssl_chain_required)
* [statsd\_dsn](https://charmhub.io/launchpad-librarian/configurations#statsd_dsn)
* [statsd\_environment](https://charmhub.io/launchpad-librarian/configurations#statsd_environment)
* [storage\_managed\_by\_juju](https://charmhub.io/launchpad-librarian/configurations#storage_managed_by_juju)
* [storm\_cache\_size](https://charmhub.io/launchpad-librarian/configurations#storm_cache_size)
* [swift\_auth\_url](https://charmhub.io/launchpad-librarian/configurations#swift_auth_url)
* [swift\_auth\_version](https://charmhub.io/launchpad-librarian/configurations#swift_auth_version)
* [swift\_container\_name](https://charmhub.io/launchpad-librarian/configurations#swift_container_name)
* [swift\_feed\_workers](https://charmhub.io/launchpad-librarian/configurations#swift_feed_workers)
* [swift\_password](https://charmhub.io/launchpad-librarian/configurations#swift_password)
* [swift\_project\_domain\_name](https://charmhub.io/launchpad-librarian/configurations#swift_project_domain_name)
* [swift\_region\_name](https://charmhub.io/launchpad-librarian/configurations#swift_region_name)
* [swift\_storage\_url](https://charmhub.io/launchpad-librarian/configurations#swift_storage_url)
* [swift\_tenant\_name](https://charmhub.io/launchpad-librarian/configurations#swift_tenant_name)
* [swift\_timeout](https://charmhub.io/launchpad-librarian/configurations#swift_timeout)
* [swift\_use\_proxy](https://charmhub.io/launchpad-librarian/configurations#swift_use_proxy)
* [swift\_user\_domain\_name](https://charmhub.io/launchpad-librarian/configurations#swift_user_domain_name)
* [swift\_username](https://charmhub.io/launchpad-librarian/configurations#swift_username)
* [throttled\_retry\_after](https://charmhub.io/launchpad-librarian/configurations#throttled_retry_after)
* [throttled\_user\_agent\_platforms](https://charmhub.io/launchpad-librarian/configurations#throttled_user_agent_platforms)
* [throttled\_user\_agents](https://charmhub.io/launchpad-librarian/configurations#throttled_user_agents)
* [trusted\_networks](https://charmhub.io/launchpad-librarian/configurations#trusted_networks)
* [ubuntu\_disable\_filebug](https://charmhub.io/launchpad-librarian/configurations#ubuntu_disable_filebug)
* [uploader\_default\_recipient](https://charmhub.io/launchpad-librarian/configurations#uploader_default_recipient)
* [uploader\_default\_sender](https://charmhub.io/launchpad-librarian/configurations#uploader_default_sender)
* [upstream\_host](https://charmhub.io/launchpad-librarian/configurations#upstream_host)
* [upstream\_port](https://charmhub.io/launchpad-librarian/configurations#upstream_port)
* [use\_per\_vhost\_certificate](https://charmhub.io/launchpad-librarian/configurations#use_per_vhost_certificate)
* [webhooks\_proxy\_url](https://charmhub.io/launchpad-librarian/configurations#webhooks_proxy_url)
* [webmaster\_email](https://charmhub.io/launchpad-librarian/configurations#webmaster_email)
* [workers](https://charmhub.io/launchpad-librarian/configurations#workers)

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

* active | boolean

  Default: True

  If true, enable jobs that may change the database.
* backfill\_sha512\_workers | int

  Default: 2

  Number of parallel download workers for librarian-backfill-sha512.
* blocked\_referers | string

  '|' separated list of referrers that should be blocked. Matching requests receive a 403 response.
* blocked\_user\_agents | string

  '|' separated list of user agents that should be blocked. Matching requests receive a 403 response.
* bounce\_address | string

  Default: noreply@launchpad.test

  Envelope sender address for outgoing email.
* build\_label | string

  Build label to deploy (only used when fetching the payload rather than embedding it in the charm).
* bzr\_imports\_root\_url | string

  Internal URL prefix for Bazaar branches imported from other revision control systems, used by the branch puller.
* bzr\_lp\_prefix | string

  Default: lp://dev/

  URL prefix used to address Bazaar branches on this instance.
* bzr\_lp\_url\_hosts | string

  Default: dev

  Comma-separated list of hosts which may be used to refer to this server's branches in "lp:" URLs.
* candid\_service\_root | string

  URL to the Candid service, used to discharge certain kinds of macaroons.
* charmhub\_secrets\_public\_key | string

  Base64-encoded NaCl public key for encrypting Charmhub upload tokens.
* charmhub\_storage\_url | string

  Charmhub's storage URL endpoint.
* charmhub\_url | string

  Charmhub's primary URL endpoint.
* cron\_control\_url | string

  Default: file:cronscripts.ini

  URL of file used to control whether cron scripts run.
* cron\_mailto | string

  Default: error-reports@launchpad.test

  Email address for output from cron jobs.
* databases | string

  YAML-encoded information about database relations, overriding the defaults. For example, setting this to "db: {name: launchpad\_prod}" changes the name of the database used by the "db" relation.
* db\_name | string

  database name
* db\_roles | string

  comma separated list of roles
* db\_statement\_timeout | int

  SQL statement timeout in milliseconds.
* debuglog | string

  If set to a writable path, application will write size/time constrained
  debug level logs to that path on the unit, see
  http://talisker.readthedocs.io/en/latest/logging.html#debug-logging for
  details.
* default\_batch\_size | int

  Default: 50

  The default size used in a batched listing of results.
* domain | string

  Default: launchpad.test

  Domain name for this instance.
* domain\_bzr | string

  Domain name for this instance's Bazaar service, if any.
* domain\_git | string

  Domain name for this instance's Git service, if any.
* domain\_librarian | string

  Default: launchpadlibrarian.test

  Domain name for this instance's librarian service.
* domain\_librarian\_aliases | string

  Default: []

  A YAML-encoded list of aliases for the librarian's primary domain.
* domain\_lists | string

  Domain name for this instance's mailing list service, if any.
* domain\_xmlrpc\_private | string

  Default: xmlrpc-private.launchpad.test

  Domain name for this instance's private XML-RPC service.
* env\_extra | string

  Default: {}

  extra environment varibles to include in the process, as a python dict literal
* environment | string

  Default: production

  production, staging, or devel
* extra\_packages | string

  Space separated list of extra deb packages to install.
* frontend\_proxy\_protocol\_enabled | boolean

  Accept PROXY protocol headers from the upstream load balancer and log the real client IP. Enable only when the load balancer is configured to send PROXY protocol headers.
* geoip\_database | string

  The database used by our GeoIP library. Only GeoIP2/GeoLite2 Country databases are supported.
* git\_loose\_objects\_threshold | int

  Threshold for the number of loose objects that triggers automatic repacking of Git repositories.
* git\_packs\_threshold | int

  Threshold for the number of pack files that triggers automatic repacking of Git repositories.
* gpg\_upload\_keys | boolean

  Should we allow uploading keys to the keyserver?
* haproxy\_server\_options | string

  Default: check inter 5000 rise 2 fall 5 maxconn 16

  Options to add to HAProxy "server" lines.
* haproxy\_service\_options\_download | string

  Default: - mode http
  - option httplog
  - option httpchk HEAD / HTTP/1.0
  - option forwardfor
  - balance leastconn

  HAProxy options for download services.
* haproxy\_service\_options\_upload | string

  Default: - mode tcp
  - option tcplog
  - option httpchk HEAD / HTTP/1.0
  - option forwardfor
  - balance leastconn
  - timeout client 600000
  - timeout server 600000

  HAProxy options for upload services.
* http\_proxy | string

  Proxy to be used when issuing HTTP requests.
* install\_keys | string

  Default: - null # PPA keys securely added via Launchpad.

  List of signing keys for install\_sources package sources, per charmhelpers standard format (a yaml list of strings encoded as a string). The keys should be the full ASCII armoured GPG public keys. While GPG key ids are also supported and looked up on a keyserver, operators should be aware that this mechanism is insecure. null can be used if a standard package signing key is used that will already be installed on the machine, and for PPA sources where the package signing key is securely retrieved from Launchpad.
* install\_sources | string

  Default: - ppa:launchpad/ppa

  List of extra apt sources, per charm-helpers standard format (a yaml list of strings encoded as a string). Each source may be either a line that can be added directly to sources.list(5), or in the form ppa:<user>/<ppa-name> for adding Personal Package Archives, or a distribution component to enable.
* internal\_bzr\_api\_endpoint | string

  The URL of the internal Bazaar hosting API endpoint.
* internal\_git\_api\_endpoint | string

  The URL of the internal Git hosting API endpoint.
* is\_demo | boolean

  Default: True

  Should pages be styled to indicate the use of a demo system?
* librarian\_download\_host | string

  Host the Librarian is listening on for HTTP requests.
* librarian\_download\_port | int

  Port number the Librarian listens for HTTP GET and HEAD requests on.
* librarian\_download\_url | string

  The base URL used to generate URLs to the Library contents.
* librarian\_restricted\_download\_host | string

  Host the Restricted Librarian is listening on for HTTP requests.
* librarian\_restricted\_download\_port | int

  Port number the Restricted Librarian listens for HTTP GET and HEAD requests on.
* librarian\_restricted\_download\_url | string

  The base URL used to generate URLs to the Restricted Library contents.
* librarian\_restricted\_upload\_host | string

  Host the Restricted Librarian is listening on for storage requests.
* librarian\_restricted\_upload\_port | int

  Port number the Restricted Librarian listens for storage requests on.
* librarian\_upload\_host | string

  Host the Librarian is listening on for storage requests.
* librarian\_upload\_port | int

  Port number the Librarian listens for storage requests on.
* log\_hosts\_allow | string

  Hosts that should be allowed to rsync logs. Note that this relies on the nrpe subordinate charm to set up /etc/rsyncd.conf properly.
* mailman\_shared\_secret | string

  Shared secret used to pre-approve Launchpad-generated messages to Launchpad mailing lists.
* nagios\_context | string

  Used by the nrpe subordinate charms.
* nagios\_servicegroups | string

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

  Base64-encoded NaCl public key for encrypting OCI registry upload credentials.
* old\_os\_auth\_url | string

  OpenStack authentication URL for a previous Swift instance that we're migrating away from, but should still read from if necessary.
* old\_os\_auth\_version | string

  Default: 2.0

  OpenStack authentication protocol version for a previous Swift instance that we're migrating away from, but should still read from if necessary.
* old\_os\_password | string

  OpenStack password for a previous Swift instance that we're migrating away from, but should still read from if necessary.
* old\_os\_tenant\_name | string

  OpenStack tenant name for a previous Swift instance that we're migrating away from, but should still read from if necessary.
* old\_os\_username | string

  OpenStack username for a previous Swift instance that we're migrating away from, but should still read from if necessary.
* oops\_prefix | string

  Default: TEST

  A prefix for OOPS codes for this instance.
* oops\_rabbitmq\_broker\_urls | string

  Space-separated list of RabbitMQ broker URLs for a separate cluster dedicated to OOPS reports. If unset, rely on the oops-amqp relation instead; if that is also absent, OOPS reports use the same cluster as rabbitmq\_broker\_urls / the rabbitmq relation.
* oops\_rabbitmq\_user | string

  Default: test

  Username to use with the OOPS RabbitMQ cluster.
* openid\_alternate\_provider\_roots | string

  Comma-separated list of additional URLs to recognise as valid prefixes for our accounts' OpenID identifiers.
* openid\_provider\_root | string

  Default: https://testopenid.test/

  URL to the OpenID provider to authenticate against.
* os\_auth\_url | string

  OpenStack authentication URL.
* os\_auth\_version | string

  Default: 2.0

  OpenStack authentication protocol version.
* os\_password | string

  OpenStack password.
* os\_tenant\_name | string

  OpenStack tenant name.
* os\_username | string

  OpenStack username.
* package\_status | string

  Default: install

  The status of service-affecting packages will be set to this value in the dpkg database. Valid values are "install" and "hold".
* port\_download\_base | int

  Default: 8000

  Base port number for public download workers.
* port\_restricted\_download\_base | int

  Default: 8005

  Base port number for restricted download workers.
* port\_restricted\_upload\_base | int

  Default: 9095

  Base port number for restricted upload workers.
* port\_upload\_base | int

  Default: 9090

  Base port number for public upload workers.
* port\_xmlrpc | int

  Default: 8087

  Port for the XML-RPC application server.
* ppa\_base\_url | string

  Default: http://ppa.launchpad.test/

  External base URL for PPAs.
* ppa\_private\_base\_url | string

  Default: http://private-ppa.launchpad.test/

  External base URL for private PPAs.
* profile\_dir | string

  Directory to save profile info. The filename is in the format <timestamp>-<threadName>.prof. When unset, defaults to the current directory (.) as specified in schema-lazr.conf in the Launchpad tree.
* rabbitmq\_broker\_urls | string

  Space-separated list of RabbitMQ broker URLs. If unset, rely on the rabbitmq relation instead.
* rabbitmq\_user | string

  Default: test

  Username to use with RabbitMQ.
* restricted\_librarian\_abuse\_mitigation | boolean

  Whether to apply the abuse-mitigation rules (blocked\_user\_agents, blocked\_referers, throttled\_user\_agents) to the restricted librarian vhost as well.
* send\_email | boolean

  Is this service allowed to send email? (Email is always sent via a mail transport agent running on localhost; deploy a postfix-relay subordinate charm to handle this.)
* sentry\_dsn | string

  DSN for configuration of Sentry's raven client.
  See https://<sentry\_host>/sentry/snapdeltaservice/settings/keys/
* session\_cookie\_name | string

  Default: launchpad\_dev

  The ID of the cookie used to store the session token.
* site\_message | string

  If provided, this message will appear in the site status bar at the top of every page.
* slow\_query\_timeout | string

  Default: -1

  Timeout (in ms) to log SQL queries
* snap\_store\_secrets\_public\_key | string

  Base64-encoded NaCl public key for encrypting snap store upload tokens.
* snap\_store\_upload\_url | string

  The snap store's upload URL endpoint.
* snap\_store\_url | string

  The snap store's primary URL endpoint.
* soft\_request\_timeout | int

  Soft request timeout in milliseconds.
* ssl\_chain\_required | boolean

  Whether an intermediate certificate chain is needed for this service. In development, we use self-signed certificates which don't have a certificate chain; but in real deployments, we need to send a certificate chain.
* statsd\_dsn | string

  statsd url, see http://talisker.readthedocs.io/en/latest/statsd.html for details
* statsd\_environment | string

  Statsd environment name.
* storage\_managed\_by\_juju | boolean

  Indicates whether the storage is managed by Juju. Must be set during deployment time. Refer to the launchpad-storage layer's README for more information.
* storm\_cache\_size | int

  Default: 10000

  The size of the Storm cache in objects.
* swift\_auth\_url | string

  URL for authenticating against Keystone when fetching payloads from Swift.
* swift\_auth\_version | string

  Default: 2

  Auth version, supported values: 2, 3.
* swift\_container\_name | string

  Container to use when fetching payloads from Swift.
* swift\_feed\_workers | int

  Default: 1

  Number of librarian-feed-swift workers to run in parallel.
* swift\_password | string

  Password to use when fetching payloads from Swift.
* swift\_project\_domain\_name | string

  Default: default

  Openstack project domain name
* swift\_region\_name | string

  Region to use when fetching payloads from Swift.
* swift\_storage\_url | string

  URL for fetching payloads anonymously from Swift.
* swift\_tenant\_name | string

  OpenStack tenant to use when fetching payloads from Swift.
* swift\_timeout | int

  Default: 15

  Time in seconds to wait for a response from Swift.
* swift\_use\_proxy | boolean

  use http{s} proxy, if defined in the environment variables: JUJU\_CHARM\_HTTP{S}\_PROXY
* swift\_user\_domain\_name | string

  Default: default

  Openstack user domain name
* swift\_username | string

  Username to use when fetching payloads from Swift.
* throttled\_retry\_after | int

  Default: 3600

  Seconds advertised in the Retry-After header of a 429 response. This option has no effect unless throttled\_user\_agents is also set.
* throttled\_user\_agent\_platforms | string

  '|' separated list of platforms that should be throttled. The platforms are specified within parentheses in the user agent string. This is combined with throttled\_user\_agents. When empty, throttling matches only on the user agent pattern. Matching requests receive a 429 response with a Retry-After header. This option has no effect unless throttled\_user\_agents is also set.
* throttled\_user\_agents | string

  '|' separated list of user agents that should be throttled. Matching requests receive a 429 response with a Retry-After header.
* trusted\_networks | string

  Space-separated list of networks with trusted access to this service.
* ubuntu\_disable\_filebug | boolean

  Should +filebug be disabled for Ubuntu?
* uploader\_default\_recipient | string

  Default email recipient for package upload notifications.
* uploader\_default\_sender | string

  Default email sender for package upload notifications.
* upstream\_host | string

  Host name for the upstream librarian, if any.
* upstream\_port | int

  Default: 80

  Port for the upstream librarian, if any.
* use\_per\_vhost\_certificate | boolean

  Whether the restricted librarian vhost uses its own "restricted." certificate. When false, it reuses the main librarian certificate.
* webhooks\_proxy\_url | string

  Outbound webhook request proxy URL.
* webmaster\_email | string

  Default: webmaster@launchpad.test

  Email address to include in Apache virtual host configuration.
* workers | int

  Default: 1

  Number of librarian worker processes. If set, each worker will listen on consecutive ports starting from each of `port_download_base`, `port_restricted_download_base`, `port_restricted_upload_base`, and `port_upload_base`, so make sure there is enough space between those.
