# Ubuntu Pro Client

> Documentation for Ubuntu Pro Client (the pro command), used to enable and
> manage Ubuntu Pro services such as ESM, Livepatch and FIPS.


2026

## Pages

- [Ubuntu Pro Client](https://ubuntu.com/pro-client/docs/latest/index.html.md): Whether you’re an enterprise customer deploying systems at scale or
- [Explanation](https://ubuntu.com/pro-client/docs/latest/explanations/index.html.md): Our explanatory and conceptual guides are written to provide a better
- [Reference](https://ubuntu.com/pro-client/docs/latest/references/index.html.md): Our reference section contains technical information for the Ubuntu Pro Client.
- [How-to guides](https://ubuntu.com/pro-client/docs/latest/howtoguides/index.html.md): If you have a specific goal and are already familiar with the Ubuntu Pro Client
- [Tutorial](https://ubuntu.com/pro-client/docs/latest/tutorials/index.html.md): This section contains step-by-step tutorials to show what the Ubuntu Pro Client
- [Compatibility matrix for Ubuntu Pro services](https://ubuntu.com/pro-client/docs/latest/references/compatibility_matrix/index.html.md): Some Ubuntu Pro services are compatible with each other. The following
- [Support matrix for the Ubuntu Pro Client](https://ubuntu.com/pro-client/docs/latest/references/support_matrix/index.html.md): Ubuntu Pro services are only available on Ubuntu Long Term Support (LTS)
- [Errors you may encounter and their meaning](https://ubuntu.com/pro-client/docs/latest/references/errors_explained/index.html.md): If you encounter an error or warning message from Pro Client that you don’t
- [The Ubuntu Pro API reference guide](https://ubuntu.com/pro-client/docs/latest/references/api/index.html.md): The Ubuntu Pro Client has a Python-based API to be consumed by users who want
- [The Ubuntu Pro CLI reference guide](https://ubuntu.com/pro-client/docs/latest/references/commands/index.html.md): This is a list of the commands and subcommands available in the Pro Client.
- [Ubuntu Pro Client network requirements](https://ubuntu.com/pro-client/docs/latest/references/network_requirements/index.html.md): The Ubuntu Pro Client (`pro`) and Ubuntu Pro services need to make network
- [Ubuntu Pro Client PPAs](https://ubuntu.com/pro-client/docs/latest/references/ppas/index.html.md): There are two Personal Package Archives (PPAs) with different release
- [Exploring your system’s security with Pro](https://ubuntu.com/pro-client/docs/latest/tutorials/security-with-pro/index.html.md): Whether you’re running the latest Ubuntu LTS release, or a release at the end
- [Host your own APT news](https://ubuntu.com/pro-client/docs/latest/tutorials/host_apt_news/index.html.md): APT news is used to deliver messages related to APT updates. However, it can also be used to display...
- [Get started with Ubuntu Pro Client](https://ubuntu.com/pro-client/docs/latest/tutorials/basic_commands/index.html.md): The Ubuntu Pro Client (`pro`) provides a simple mechanism for viewing,
- [The `pro status` output explained](https://ubuntu.com/pro-client/docs/latest/explanations/status_columns/index.html.md): When running `pro status` we can observe two different types of output, which
- [Which services are for me?](https://ubuntu.com/pro-client/docs/latest/explanations/which_services/index.html.md): Ubuntu Pro is a broad subscription designed to meet many different needs. You
- [Messaging](https://ubuntu.com/pro-client/docs/latest/explanations/index_messages/index.html.md): Here you’ll find details about Ubuntu Pro Client-related APT and MOTD messages
- [Pro services](https://ubuntu.com/pro-client/docs/latest/explanations/index_services/index.html.md): Ubuntu Pro is a portal to many other services offered by Canonical. Here you
- [Handling security vulnerabilities](https://ubuntu.com/pro-client/docs/latest/explanations/index_security/index.html.md): Ubuntu Pro provides security fixes for vulnerabilities (CVEs and USNs). This
- [Timer jobs explained](https://ubuntu.com/pro-client/docs/latest/explanations/what_are_the_timer_jobs/index.html.md): Ubuntu Pro Client (`pro`) sets up a `systemd` timer to run jobs that need
- [Ubuntu Pro policies](https://ubuntu.com/pro-client/docs/latest/explanations/index_policies/index.html.md): Here we explain our usage policies for features such as using Pro offline or
- [What is the Pro daemon?](https://ubuntu.com/pro-client/docs/latest/explanations/what_is_the_daemon/index.html.md): Ubuntu Pro Client sets up a daemon for two types of machines:
- [Machine counts and token usage for Ubuntu Pro](https://ubuntu.com/pro-client/docs/latest/explanations/pro_token_and_machine_usage/index.html.md): Ubuntu Pro tokens are used to authenticate your machine and enable access to the services you are en...
- [Common scenarios when using `pro fix` to solve a CVE/USN](https://ubuntu.com/pro-client/docs/latest/explanations/fix_scenarios/index.html.md): The Ubuntu Pro Client (`pro`) can be used to inspect and resolve
- [Ubuntu Pro-related MOTD messages](https://ubuntu.com/pro-client/docs/latest/explanations/motd_messages/index.html.md): When the Ubuntu Pro Client (`pro`) is installed on the system, it delivers
- [How to interpret the output of CVE commands](https://ubuntu.com/pro-client/docs/latest/explanations/how_to_interpret_output_of_pro_cve_commands/index.html.md): In the Pro Client version 35, we introduce the `pro cves` command.
- [What data is collected from active Ubuntu Pro machines?](https://ubuntu.com/pro-client/docs/latest/explanations/data_collection/index.html.md): If a machine is attached to an Ubuntu Pro subscription, the following data is
- [What does `security-status` do?](https://ubuntu.com/pro-client/docs/latest/explanations/how_to_interpret_the_security_status_command/index.html.md): The `security-status` command provides an overview of all the packages
- [How to interpret the output of the fix plan API endpoint](https://ubuntu.com/pro-client/docs/latest/explanations/how_to_interpret_output_of_fix_plan_api/index.html.md): In the Pro Client version 29, we introduce two distinct endpoints:
- [CVEs and USNs explained](https://ubuntu.com/pro-client/docs/latest/explanations/cves_and_usns_explained/index.html.md): Common Vulnerabilities and Exposures (CVEs) are a way to catalog and track
- [About Public Cloud Ubuntu Pro images](https://ubuntu.com/pro-client/docs/latest/explanations/what_are_ubuntu_pro_cloud_instances/index.html.md): Ubuntu Pro images are published to [AWS](https://ubuntu.com/aws/pro), [Azure](https://ubuntu.com/azu...
- [Ubuntu Pro-related APT messages](https://ubuntu.com/pro-client/docs/latest/explanations/apt_messages/index.html.md): When running some APT commands, you might see Ubuntu Pro-related messages in
- [Using Ubuntu Pro airgapped](https://ubuntu.com/pro-client/docs/latest/explanations/using_pro_offline/index.html.md): Airgapping (or air gapping) is a security measure that involves isolating a
- [Disabling and purging services](https://ubuntu.com/pro-client/docs/latest/explanations/purging_services/index.html.md): All services enabled using the Pro Client can be disabled using the command
- [How to interpret the output of unattended-upgrades](https://ubuntu.com/pro-client/docs/latest/explanations/how_to_interpret_output_of_unattended_upgrades/index.html.md): In Pro Client version 27.14~, we introduced the
- [About ESM, esm-apps and esm-infra](https://ubuntu.com/pro-client/docs/latest/explanations/about_esm/index.html.md): In the earlier version of Ubuntu Pro, when security fixes were only guaranteed
- [Ubuntu Pro Client feature deprecation policy](https://ubuntu.com/pro-client/docs/latest/explanations/deprecation_policy/index.html.md): When the Pro Client introduces new features, particularly features designed for
- [How to disable or re-enable APT News](https://ubuntu.com/pro-client/docs/latest/howtoguides/disable_enable_apt_news/index.html.md): APT News is a feature that allows for timely package-related news to be
- [How to configure a proxy](https://ubuntu.com/pro-client/docs/latest/howtoguides/configure_proxies/index.html.md): The Ubuntu Pro Client can be configured to use an HTTP/HTTPS proxy as needed
- [How to preview the result of the `pro fix` command](https://ubuntu.com/pro-client/docs/latest/howtoguides/fix_how_to_know_what_the_fix_command_would_change/index.html.md): As outlined in our explanation of the different scenarios encountered when
- [How to get Ubuntu Pro on LXD guests](https://ubuntu.com/pro-client/docs/latest/howtoguides/use_pro_lxd_guests/index.html.md): Pro client v35 allows LXD guests to get Ubuntu Pro during boot. For the integration to
- [How to simulate the `attach` operation](https://ubuntu.com/pro-client/docs/latest/howtoguides/how_to_simulate_attach/index.html.md): If you are unsure what the state of your machine will be after running
- [How to enable Ubuntu Pro Services in a Dockerfile](https://ubuntu.com/pro-client/docs/latest/howtoguides/enable_in_dockerfile/index.html.md): Ubuntu Pro comes with several services, some of which can be useful in Docker.
- [How to manage Expanded Security Maintenance (ESM) services](https://ubuntu.com/pro-client/docs/latest/howtoguides/enable_esm_infra/index.html.md): For Ubuntu LTS releases, ESM for Infrastructure (`esm-infra`) and ESM for
- [How to check if a system is affected by a CVE/USN?](https://ubuntu.com/pro-client/docs/latest/howtoguides/fix_how_to_know_if_system_affected_by_cve/index.html.md): The Ubuntu Pro Client (`pro`) can be used to inspect and resolve
- [How to manage Livepatch](https://ubuntu.com/pro-client/docs/latest/howtoguides/enable_livepatch/index.html.md): For Ubuntu LTS releases, [Livepatch](https://ubuntu.com/security/livepatch) is automatically enabled...
- [How to manage Landscape](https://ubuntu.com/pro-client/docs/latest/howtoguides/enable_landscape/index.html.md): You can register a machine with Landscape via the `pro enable landscape`
- [How to get rid of a corrupt lock](https://ubuntu.com/pro-client/docs/latest/howtoguides/get_rid_of_corrupt_lock/index.html.md): Some Pro Client commands (`attach`, `enable`, `detach` and `disable`)
- [How to configure a TLS-in-TLS proxy](https://ubuntu.com/pro-client/docs/latest/howtoguides/configure_tls_in_tls_proxy/index.html.md): If you need to set `https_proxy` to a proxy that uses `https://` (a
- [How to manage FIPS](https://ubuntu.com/pro-client/docs/latest/howtoguides/enable_fips/index.html.md): The latest FedRAMP policy on the use of cryptographic modules relaxes some
- [Create an Ubuntu FIPS Docker image](https://ubuntu.com/pro-client/docs/latest/howtoguides/create_a_fips_docker_image/index.html.md): This tutorial requires at least Ubuntu Pro Client version 27.7 – to check
- [How to update MOTD and APT messages](https://ubuntu.com/pro-client/docs/latest/howtoguides/update_motd_messages/index.html.md): Since `ubuntu-pro-client` is responsible for enabling ESM services, we
- [How to enable esm-infra-legacy on Trusty](https://ubuntu.com/pro-client/docs/latest/howtoguides/trusty_legacy_support/index.html.md): The `esm-infra-legacy` service can be enabled with the Legacy Support add-on to grant an additional ...
- [How to enable Real-time Ubuntu](https://ubuntu.com/pro-client/docs/latest/howtoguides/enable_realtime_kernel/index.html.md): [Real-time Ubuntu](https://ubuntu.com/realtime-kernel) is supported on specific Ubuntu releases. To
- [How to resolve a specific CVE or USN](https://ubuntu.com/pro-client/docs/latest/howtoguides/fix_how_to_resolve_given_cve/index.html.md): In this guide, we will introduce the `pro fix` command and show how you can use it to resolve CVEs/U...
- [How to preview the results when fixing multiple CVEs](https://ubuntu.com/pro-client/docs/latest/howtoguides/fix_how_to_better_visualize_fixing_multiple_cves/index.html.md): To fix multiple CVEs, you need to use the `u.pro.security.fix.cve.execute.v1`
- [How to skip fixing related USNs](https://ubuntu.com/pro-client/docs/latest/howtoguides/fix_how_to_not_fix_related_usns/index.html.md): The general scenarios you might encounter when running `pro fix` are
- [How to enable CIS or USG](https://ubuntu.com/pro-client/docs/latest/howtoguides/enable_cis/index.html.md): On Ubuntu 20.04 LTS (Focal) and later releases, CIS was
- [How to check your Ubuntu Pro Client version](https://ubuntu.com/pro-client/docs/latest/howtoguides/check_pro_version/index.html.md): There are two ways to check the current version of the Ubuntu Pro Client you
- [How to manage Ubuntu Pro attachment when moving machines](https://ubuntu.com/pro-client/docs/latest/howtoguides/how_to_migrate_attached_machines/index.html.md): This guide explains what happens to your Ubuntu Pro attachment when you move,
- [How to collect Ubuntu Pro Client logs](https://ubuntu.com/pro-client/docs/latest/howtoguides/how_to_collect_logs/index.html.md): When reporting a bug it is helpful to include your logs. To collect all of the
- [Handle vulnerabilities](https://ubuntu.com/pro-client/docs/latest/howtoguides/fix_index/index.html.md): Using the Pro Client, you can handle individual vulnerabilities (both CVEs and
- [How to configure a timer job](https://ubuntu.com/pro-client/docs/latest/howtoguides/configuring_timer_jobs/index.html.md): All timer jobs can be configured through the `pro config set` command.
- [Configure messages](https://ubuntu.com/pro-client/docs/latest/howtoguides/configure_index/index.html.md): You can choose whether (and how) to display APT and MOTD messages, set timer
- [How to create a customized Cloud Ubuntu Pro image](https://ubuntu.com/pro-client/docs/latest/howtoguides/create_pro_golden_image/index.html.md): * Launch an Ubuntu Pro instance on your cloud of choice
- [How to attach with a configuration file](https://ubuntu.com/pro-client/docs/latest/howtoguides/how_to_attach_with_config_file/index.html.md): To attach with a configuration file, you can run `pro attach` with the
- [Attaching machines](https://ubuntu.com/pro-client/docs/latest/howtoguides/attach_index/index.html.md): To access Ubuntu Pro services, you need to first attach your machine to a
- [How to manage CC EAL](https://ubuntu.com/pro-client/docs/latest/howtoguides/enable_cc/index.html.md): [Common Criteria](https://ubuntu.com/security/cc) is supported only on Ubuntu 16.04 (Xenial) and 18....
- [How to attach a machine to your Ubuntu Pro subscription](https://ubuntu.com/pro-client/docs/latest/howtoguides/how_to_attach/index.html.md): To attach your machine to a subscription, run the following command in your
- [Enable services](https://ubuntu.com/pro-client/docs/latest/howtoguides/enable_index/index.html.md): Enable, disable or check the status of the following services with the Pro
- [How to customize a cloud Ubuntu Pro image with FIPS updates](https://ubuntu.com/pro-client/docs/latest/howtoguides/create_a_fips_updates_pro_cloud_image/index.html.md): See the following links for up to date information about Pro for each supported
- [How to use custom APT configuration](https://ubuntu.com/pro-client/docs/latest/howtoguides/use_custom_apt_config/index.html.md): The Pro Client CLI is able, through the security-status command, to show
- [How to manage Anbox Cloud](https://ubuntu.com/pro-client/docs/latest/howtoguides/enable_anbox/index.html.md): To use [Anbox Cloud](https://anbox-cloud.io/), you will need to enable it directly through the
- [Check if a system is affected by a list of CVEs](https://ubuntu.com/pro-client/docs/latest/howtoguides/how_to_know_if_system_affected_by_a_list_of_cves/index.html.md): The Ubuntu Pro Client (`pro`) can be used to inspect and resolve

---

For more comprehensive documentation, see [llms-full.txt](https://ubuntu.com/pro-client/docs/latest/llms-full.txt)