bing_custom_config_id | string

Identifier for the Bing Custom Search instance.

bing_custom_search_endpoint | string

Default: https://api.bing.microsoft.com/v7.0/custom/search

The endpoint to send the Bing custom search requests to.

bing_subscription_key | string

Cognitive Services subscription key for the Bing Custom Search API.

blocked_user_agents | string

User agents that should be blocked from Launchpad, separated by '|'.

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.

csrf_secret | string

Secret used to create CSRF tokens. Currently only used in Candid interactions.

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.

devmode | boolean

Default: True

Is this server running in dev mode?

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_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.

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_macaroon_secret_key | string

Secret key for Git access tokens issued to Launchpad users. Any random string of a reasonable size (64 characters) is ok.

git_packs_threshold | int

Threshold for the number of pack files that triggers automatic repacking of Git repositories.

google_site_verification | string

If set, serve a /google{...} URL that can be used to verify domain ownership.

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_main | string

Default: - mode http - option httplog - option httpchk HEAD /_status/ping - option http-server-close - option forwardfor - http-check disable-on-404 - balance roundrobin

HAProxy options for the main port.

haproxy_service_options_xmlrpc | string

Default: - mode http - option httplog - option httpchk HEAD /_status/ping - option http-server-close - option forwardfor - http-check disable-on-404 - balance roundrobin

HAProxy options for the XML-RPC port.

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_bzr_codebrowse_endpoint | string

The URL of the internal Bazaar code browsing endpoint.

internal_macaroon_secret_key | string

Secret key for macaroons used to grant permissions to various internal components of Launchpad. Any random string of a reasonable size (64 characters) is ok.

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.

logrotate_frequency | string

Default: daily

Frequency of logrotate (daily or hourly)

mailman_archive_url_template | string

Default: http://lists.launchpad.test/$team_name

Template expanded to form URLs for Launchpad list archives.

mailman_shared_secret | string

Shared secret used to pre-approve Launchpad-generated messages to Launchpad mailing lists.

min_legitimate_account_age | int

Minimum account age in days that indicates a legitimate user.

min_legitimate_karma | int

Minimum karma value that indicates a legitimate user.

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.

oops_prefix | string

Default: TEST

A prefix for OOPS codes for this instance.

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.

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_main | int

Default: 8085

Port for the main application server.

port_main_cached | int

Default: 8086

Port for the main application server via Squid.

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.

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.

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.

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_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_user_domain_name | string

Default: default

Openstack user domain name

swift_username | string

Username to use when fetching payloads from Swift.

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.

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.

wsgi_worker_max_requests | int

Default: 1000

Restart WSGI worker processes after handling this many requests. This works around memory leaks.

wsgi_workers | int

The number of worker processes for handling requests. The default is 0, indicating twice the number of CPUs plus one.

Channel	Revision	Published	Runs on
latest/stable	853	05 Sep 2025	Ubuntu 20.04
latest/stable	2	14 Mar 2023	Ubuntu 20.04
latest/stable	3	14 Mar 2023	Ubuntu 20.04
latest/stable	4	14 Mar 2023	Ubuntu 20.04

launchpad-appserver