• Logo
    Landscape
  • ubuntu.com/landscape
  • More resources
    • Discourse
    • GitHub
Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
Landscape documentation
Landscape documentation
  • Landscape Documentation
  • What is Landscape?
  • Tutorial
  • How-to guides
    • Landscape installation and set-up
      • Cloud providers
        • Install on Google Cloud
        • Install on Microsoft Azure
        • Set up Ubuntu Amazon WorkSpaces
      • 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 Outbox
      • Configure Postfix
      • Set up Deb Archive
    • Upgrade
      • Upgrade Landscape
      • Upgrade to Landscape 26.04 LTS
      • Upgrade to Landscape 24.04 LTS
      • Upgrade to Landscape 26.04 LTS (charm)
    • Backup and maintenance
      • Backup and restore
      • Backup and restore a charmed deployment
      • Manage maintenance cron jobs
      • Remove duplicate instances
    • Ubuntu Pro
      • Attach Ubuntu Pro
      • Enable Landscape
    • External authentication
      • Active Directory
      • OIDC
      • PAM
    • 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
      • 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
      • 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
      • Configure Landscape after upgrade
      • Register WSL hosts
      • Manage WSL instances
      • Use WSL profiles
      • Perform common tasks
      • Get support
    • Ubuntu installer
      • Configure a deployment for autoinstall provisioning
      • Set up autoinstall provisioning
      • Provision a workstation
    • Security
      • Harden your deployment
      • Apply security updates
      • Use USG profiles
    • 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
      • Common Landscape Client issues
      • Idle activities
  • Reference
    • API
      • REST API endpoints
        • Accounts
        • Activities
        • Administrators
        • Alerts
        • Beta-only
        • Child Instance Profiles
        • Computers
        • Credentials
        • GPG Key
        • Invitations
        • License Management
        • Livepatch
        • Login
        • Packages
        • Password
        • Person
        • Preferences
        • Processes
        • Reboot Profiles
        • FDE Recovery Key
        • Repositories
        • Repository Profiles
        • Script Profiles
        • Scripts
        • Snaps
        • Switch Account
        • Tokens
        • Users
        • USG Profiles
        • WSL
      • Legacy API endpoints
        • Activities
        • Administrators
        • Alerts
        • Computers
        • Event Log
        • GPG
        • Package Profiles
        • Packages
        • Removal Profiles
        • Reporting
        • Repositories
        • Role Based Access Control
        • Saved Searches
        • Scripts
        • Upgrade Profiles
        • WSL
      • Debarchive API
    • Release notes
      • 26.04 LTS release notes
      • 24.04 LTS release notes
      • 25.10 release notes
      • 25.04 release notes
      • 24.10 release notes
      • Older release notes
        • 23.10 release notes
        • 23.03 release notes
        • 19.10 release notes
        • 19.01 release notes
        • 18.03 release notes
        • 17.03 release notes
        • 16.06 release notes
        • 16.03 release notes
        • 15.11 release notes
        • 15.10 release notes
        • 15.01 release notes
        • 14.10 release notes
    • Configuration
      • Immutable configuration settings
      • The service.conf file
      • Landscape Outbox configuration reference
    • Networking
      • Internal network requirements
      • Network firewall
    • Landscape Server Charm
      • HAProxy route endpoints
    • Terms
      • Access groups
      • Administrators
      • Profiles
      • Roles
      • Tags
    • Supported versions and PPAs
    • Logs
    • Database
    • Known issues
    • lsctl
  • Explanation
    • Landscape
      • About Landscape
      • Deployment models
      • Self-hosted Landscape
      • Licenses
      • Landscape Server architecture
      • Landscape Client architecture
    • Landscape Server charm
      • Charm integration compatibility
      • PgBouncer integration
    • Features
      • Activities
      • Alerts
      • Repository mirroring (pre-26.04)
      • Repository mirroring (26.04+)
      • Package reporting
      • Remote script execution
      • Full Disk Encryption recovery keys
    • Security
      • Security overview
      • Cryptographic technology
      • Data handling
      • Authentication and authorization
      • AppArmor
      • Disclosure and reporting
    • Related tools
      • Landscape and Ansible
  • Contribute to our documentation
Back to top
Contribute to this page

TroubleshootingΒΆ

Diagnose and resolve common Landscape issues.

  • Common Landscape Client issues
  • Idle activities
Copyright © 2026 CC-BY-SA, Canonical Ltd.
Last updated on May 27, 2026
Manage your tracker settings
Ask a question on Discourse
Edit this page on GitHub
Contents
  • Troubleshooting