Landscape Server

Jan-Yaeger Dhillon Publisher

Platform:

Ubuntu
24.04
Channel Revision Published Runs on
latest/edge 14 27 Mar 2026
Ubuntu 24.04
26.04/edge 19 21 Jul 2026
Ubuntu 24.04 
juju deploy test-landscape --channel edge

Learn to deploy on juju >

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.

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

  • 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

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

  • 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-beta

    The PPA from which Landscape Server will be installed.

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

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

  • smtp_relay_host | string

    The SMTP server used to deliver outgoing mail.

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