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

# Landscape Server

[Jan-Yaeger Dhillon](https://charmhub.io/publisher/jansdhillon "View all packages from Jan-Yaeger Dhillon")

* [Jan-Yaeger Dhillon](https://charmhub.io/publisher/jansdhillon "View all packages from Jan-Yaeger Dhillon")

Platform:

24.04

edge 14

```
juju deploy test-landscape --channel edge
```

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

* [additional\_service\_config](https://charmhub.io/test-landscape/configurations#additional_service_config)
* [admin\_email](https://charmhub.io/test-landscape/configurations#admin_email)
* [admin\_name](https://charmhub.io/test-landscape/configurations#admin_name)
* [admin\_password](https://charmhub.io/test-landscape/configurations#admin_password)
* [api\_base\_port](https://charmhub.io/test-landscape/configurations#api_base_port)
* [appserver\_base\_port](https://charmhub.io/test-landscape/configurations#appserver_base_port)
* [autoregistration](https://charmhub.io/test-landscape/configurations#autoregistration)
* [cookie\_encryption\_key](https://charmhub.io/test-landscape/configurations#cookie_encryption_key)
* [db\_host](https://charmhub.io/test-landscape/configurations#db_host)
* [db\_landscape\_password](https://charmhub.io/test-landscape/configurations#db_landscape_password)
* [db\_port](https://charmhub.io/test-landscape/configurations#db_port)
* [db\_schema\_password](https://charmhub.io/test-landscape/configurations#db_schema_password)
* [db\_schema\_user](https://charmhub.io/test-landscape/configurations#db_schema_user)
* [deployment\_mode](https://charmhub.io/test-landscape/configurations#deployment_mode)
* [enable\_hostagent\_messenger](https://charmhub.io/test-landscape/configurations#enable_hostagent_messenger)
* [enable\_ubuntu\_installer\_attach](https://charmhub.io/test-landscape/configurations#enable_ubuntu_installer_attach)
* [hostagent\_server\_base\_port](https://charmhub.io/test-landscape/configurations#hostagent_server_base_port)
* [http\_proxy](https://charmhub.io/test-landscape/configurations#http_proxy)
* [https\_proxy](https://charmhub.io/test-landscape/configurations#https_proxy)
* [landscape\_ppa](https://charmhub.io/test-landscape/configurations#landscape_ppa)
* [landscape\_ppa\_key](https://charmhub.io/test-landscape/configurations#landscape_ppa_key)
* [license\_file](https://charmhub.io/test-landscape/configurations#license_file)
* [max\_global\_haproxy\_connections](https://charmhub.io/test-landscape/configurations#max_global_haproxy_connections)
* [message\_server\_base\_port](https://charmhub.io/test-landscape/configurations#message_server_base_port)
* [min\_install](https://charmhub.io/test-landscape/configurations#min_install)
* [nagios\_context](https://charmhub.io/test-landscape/configurations#nagios_context)
* [nagios\_servicegroups](https://charmhub.io/test-landscape/configurations#nagios_servicegroups)
* [no\_proxy](https://charmhub.io/test-landscape/configurations#no_proxy)
* [oidc\_client\_id](https://charmhub.io/test-landscape/configurations#oidc_client_id)
* [oidc\_client\_secret](https://charmhub.io/test-landscape/configurations#oidc_client_secret)
* [oidc\_issuer](https://charmhub.io/test-landscape/configurations#oidc_issuer)
* [oidc\_logout\_url](https://charmhub.io/test-landscape/configurations#oidc_logout_url)
* [openid\_logout\_url](https://charmhub.io/test-landscape/configurations#openid_logout_url)
* [openid\_provider\_url](https://charmhub.io/test-landscape/configurations#openid_provider_url)
* [package\_upload\_base\_port](https://charmhub.io/test-landscape/configurations#package_upload_base_port)
* [pingserver\_base\_port](https://charmhub.io/test-landscape/configurations#pingserver_base_port)
* [prometheus\_scrape\_interval](https://charmhub.io/test-landscape/configurations#prometheus_scrape_interval)
* [redirect\_https](https://charmhub.io/test-landscape/configurations#redirect_https)
* [registration\_key](https://charmhub.io/test-landscape/configurations#registration_key)
* [root\_url](https://charmhub.io/test-landscape/configurations#root_url)
* [secret\_token](https://charmhub.io/test-landscape/configurations#secret_token)
* [site\_name](https://charmhub.io/test-landscape/configurations#site_name)
* [smtp\_relay\_host](https://charmhub.io/test-landscape/configurations#smtp_relay_host)
* [system\_email](https://charmhub.io/test-landscape/configurations#system_email)
* [ubuntu\_installer\_attach\_base\_port](https://charmhub.io/test-landscape/configurations#ubuntu_installer_attach_base_port)
* [worker\_counts](https://charmhub.io/test-landscape/configurations#worker_counts)

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

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