Landscape Server

Learn about configurations >

• additional_service_config | string

  Additional service.conf settings to be merged with the default configuration.

• admin_email | string

  The email address of the initial account administrator. Note this value cannot be set more than once.

• admin_name | string

  The full name of the initial account administrator. Note this value cannot be set more than once.

• admin_password | string

  The initial password of the account administrator. Note this value cannot be set more than once.

• analytics_id | string

  Google Analytics tracker ID exposed to Landscape Server as the LANDSCAPE_ANALYTICS_ID environment variable. When unset, Landscape falls back to its built-in tracker ID for the configured deployment mode.

• api_base_port | int

  Default: 9080

  Base port for api service workers to use on each unit.

• appserver_base_port | int

  Default: 8080

  Base port for appserver service workers to use on each unit.

• autoregistration | boolean

  Bypassed Landscape administrator registration approval for clients that register using the registration password.

• bootstrap_schema_override_args | string

  Comma-separated extra arguments to append to landscape-schema --bootstrap. Example: --with-extra-computers,10,--with-openstack

• cookie_encryption_key | string

  A cookie encryption key used for API authentication flows. The value should be 32 url-safe, base64 encoded bytes. If not set, one will be generated securely.

• db_host | string

  Optionally specify the host instead of getting it from the postgres charm

• db_landscape_password | string

  Password for landscape user which does normal read/write operations

• db_port | string

  Optionally specify the db port instead of getting it from the postgres charm. Falls back to the default postgres port

• db_schema_password | string

  Password used by database admin to perform schema checks and migrations. If not set, postgres charm value, followed by db_landscape_password is used.

• db_schema_user | string

  Database admin user to perform schema checks and migrations. If not provided, the value from the postgres charm is used

• demo_data | boolean

  Whether to create demo data when running the schema migration.

• deployment_mode | string

  Default: standalone

  Landscape Server tenancy mode - do not modify unless you are able to provide the additional configuration required to run Landscape in SaaS mode.

• enable_hostagent_messenger | boolean

  Whether or not the hostagent services should run. If true, HAProxy frontends will be created to route traffic to the landscape-hostagent-messenger services. By default, those frontends will not be configured. Note that the hostagent services still need to be configured in the Landscape Server settings for the services to function.

• enable_ubuntu_installer_attach | boolean

  Whether the landscape-ubuntu-installer-attach service should run. If true, an HAProxy frontend will be created to route traffic to the Ubuntu installer attach backend services. The backend services will be installed and uninstalled automatically.

• gpg_secret_id | string

  Juju secret URI (e.g. secret:xxxx) containing the GPG credentials used by Landscape Server to sign repository metadata. The secret must contain two fields:

  • gpg-passphrase: the GPG key passphrase
  • gpg-private-key: the ASCII-armored GPG private key The secret must be granted to the landscape-server application before setting this option. When set, the charm writes the passphrase to <gpg_home_dir>/gpg-passphrase.txt and imports the private key into <gpg_home_dir> (default: /var/lib/landscape-server/gnupg) on install and whenever the secret is rotated.

• hostagent_server_base_port | int

  Default: 50052

  Port for hostagent-message-server service worker to use on each unit.

• http_proxy | string

  The HTTP proxy URL Landscape will use. If blank, the model-config value will be used.

• https_proxy | string

  The HTTPS proxy URL Landscape will use. If blank, the model-config value will be used.

• landscape_ppa | string

  Default: ppa:landscape/self-hosted-26.04

  Comma-separated list of PPAs from which Landscape Server will be installed. Each entry is passed to add-apt-repository.

• landscape_ppa_key | string

  Full ASCII-armoured GPG public key for the Landscape PPA source.

• license_file | string

  License file for Self-Hosted Landscape, either as a base64-encoded string containing the actual license file data, or a file://, http://, or https:// URL pointing to the license file for download.

• max_global_haproxy_connections | int

  Default: 4096

  Maximum number of concurrent connections HAProxy will accept globally across all frontends and backends. This sets the 'maxconn' value in the global section of the HAProxy configuration.

• message_server_base_port | int

  Default: 8090

  Base port for message-server service workers to use on each unit.

• min_install | boolean

  Does not install recommended packages like hashids to to speed up installation process.

• nagios_context | string

  Default: juju

  Used by the NRPE subordinate charms. A string that will be prepended to the instance name to set the hostname in nagios, e.g., juju-myservice-0. If you are running multiple environments with the same services in them, this allows you to differentiate them.

• nagios_servicegroups | string

  Comma-separated list of nagios servicegroups. If empty, the nagios-context will be used as the servicegroup.

• no_proxy | string

  Comma-separated list of hosts for which no proxy should be used. If blank, the model-config value will be used.

• oidc_client_id | string

  OpenID-Connect client ID.

• oidc_client_secret | string

  OpenID-Connect client secret.

• oidc_issuer | string

  OpenID-Connect issuer URL to use for Landscape Server authentication.

• oidc_logout_url | string

  OpenID-Connect issuer URL to use to log out of Landscape Servers is.

• openid_logout_url | string

  OpenID provider URL to use to log out of Landscape Server.

• openid_provider_url | string

  OpenID provider URL to use for Landscape Server authentication.

• outbox_snap_channel | string

  Default: latest/stable

  Snap channel from which to install the landscape-outbox snap. Changing this value will refresh the installed snap to the specified channel.

• package_upload_base_port | int

  Default: 9100

  Base port for package-upload service workers to use on the leader unit.

• pingserver_base_port | int

  Default: 8070

  Base port for pingserver service workers to use on each unit.

• prometheus_scrape_interval | string

  Default: 1m

  Used by the Grafana machine agent subordinate charm. The duration between Prometheus scrapes. Expects a Prometheus-style <duration> value, e.g., '1h30m5s'.

• redirect_https | string

  Default: default

  Redirect HTTP requests to HTTPS. May be one of {default|all|none}. The 'default' option will redirect all HTTP traffic except for /ping and /repository. If an invalid value is provided, the charm will remain in the maintenance status until a valid value is given.

• registration_key | string

  The initial account registration key. Note this value cannot be set more than once.

• root_url | string

  The root URL for this Landscape deployment. If left blank, the public IP of the first related HAProxy unit will be used instead.

• secret_token | string

  A secret token for the landscape service. If not set one will be generated securely.

• site_name | string

  Default: juju

  A unique site name for the Landscape deployment.

• ssl_cert | string

  Default: DEFAULT

  The base64-encoded SSL certificate to use for Landscape Server. It will be passed verbatim to the legacy HAProxy charm. If not set, a self-signed certificate will be used instead.

• ssl_key | string

  The base64-encoded private key for the SSL certificate. If ssl_cert is not set, this will be ignored. Only applicable to the legacy HAProxy charm.

• system_email | string

  The initial email address that Landscape emails will appear to come from. Note this value cannot be set more than once.

• ubuntu_installer_attach_base_port | int

  Default: 53354

  Port for ubuntu-installer-attach service worker to use on each unit.

• worker_counts | int

  Default: 2

  Number of processes to spawn for the api, app-server, message-server, and ping-server services.