How-to guides

These how-to guides cover key operations and common tasks with Landscape Server and Landscape Client.

Landscape installation and set-up

Install and configure Landscape Server and Landscape Client using various deployment modes, from quick testing setups to production deployments. These guides also cover some basic service configuration.

• Landscape installation and set-up
  • Cloud providers
  • Quickstart installation
  • SaaS account
  • Manual installation
  • Juju installation
  • Juju HA installation
  • Install in a LXD container
  • Install on FIPS-compliant machines
  • Install in a DISA STIG compliant environment
  • Install in an airgapped environment
  • Install Landscape Client
  • Configure Landscape Client
  • Configure RabbitMQ
  • Configure Postfix

Upgrade

Upgrade your Landscape Server deployment to newer versions, including migration paths to the latest LTS release.

• Upgrade
  • Upgrade Landscape
  • Upgrade to Landscape 24.04 LTS

Backup and maintenance

Protect your Landscape data and manage routine maintenance tasks including database backups and cron jobs.

• Backup and maintenance
  • Backup and restore
  • Backup and restore a charmed deployment
  • Manage maintenance cron jobs
  • Remove duplicate instances

Ubuntu Pro

Integrate Ubuntu Pro subscriptions with Landscape to manage Pro-enabled client machines.

• Ubuntu Pro
  • Attach Ubuntu Pro
  • Enable Landscape

External authentication

Configure external authentication providers for enhanced security and enterprise integration.

• External authentication
  • Active Directory
  • OIDC
  • PAM

Repository mirrors

Create and manage Ubuntu package repository mirrors for your managed machines, including support for airgapped environments.

• Repository mirrors
  • Manage repositories in the web portal
  • Manage repositories with the API
  • Manage repositories in an airgapped environment
  • Create tiered-repository mirrors

Web portal

Use Landscape’s web interface to manage computers, packages, users, and more. Landscape currently has two web portals: the modern interface (24.04+) and the classic portal.

• Web portal
  • Web portal (24.04 or later)
    • Manage instances
    • Manage administrators and roles
    • Manage access groups
    • Manage packages and snaps
    • Manage Livepatch and kernel updates
    • Use profiles
    • Use remote script execution
    • Use annotations
    • Sanitize instances
  • Classic web portal
    • Manage computers
    • Manage administrators and roles
    • Manage access groups
    • Manage packages
    • Manage snaps
    • Other tasks

IoT for devices

Manage IoT devices and Ubuntu Core systems using the Landscape Client snap, including remote script execution and basic snap management.

• IoT for devices
  • Install the snap
  • Configure the snap
  • Create an Ubuntu Core image that includes the snap
  • Use remote script execution
  • Use annotations
  • Secure removal
  • Manage snaps with validation sets

WSL integration

Manage Windows Subsystem for Linux (WSL) instances with Landscape, including registration, profiles, and common management tasks.

• WSL integration
  • Configure Landscape after upgrade
  • Register WSL hosts
  • Manage WSL instances
  • Use WSL profiles
  • Perform common tasks
  • Get support

Ubuntu installer

Automate Ubuntu workstation provisioning using Landscape with autoinstall, including OIDC authentication integration.

• Ubuntu installer
  • Configure a deployment for autoinstall provisioning
  • Set up autoinstall provisioning
  • Provision a workstation

Security

Secure your Landscape deployment and manage security updates and hardening.

• Security
  • Harden your deployment
  • Apply security updates
  • Use security profiles

API

Access Landscape programmatically using the REST API or legacy API for automation and integration.

• API
  • Make a REST API request
  • Use the legacy API
  • Use the legacy API command-line client
  • Use the legacy API via HTTPS requests
  • Use the legacy API Python module

Troubleshooting

Diagnose and resolve common Landscape issues.

• Troubleshooting
  • Idle activities