CINXE.COM
How to attach your Ubuntu Pro subscription - Landscape Docs - Ubuntu Community Hub
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>How to attach your Ubuntu Pro subscription - Landscape Docs - Ubuntu Community Hub</title> <meta name="description" content="See also: Ubuntu Pro documentation Attaching the Ubuntu Pro subscription to Ubuntu brings you the enterprise lifecycle, including Linux kernel livepatching, access to FIPS-validated packages, and compliance with secur&hellip;"> <meta name="generator" content="Discourse 3.3.0 - https://github.com/discourse/discourse version 5bbdc8a813caf55ab3147ac65b5ffafb5e0aab90"> <link rel="icon" type="image/png" href="https://ubuntucommunity.s3.us-east-2.amazonaws.com/optimized/3X/b/e/be7e4cc6ef7ce95e285337634be009b70561d719_2_32x32.png"> <link rel="apple-touch-icon" type="image/png" href="https://ubuntucommunity.s3.us-east-2.amazonaws.com/optimized/3X/f/3/f38b9c7e7decc51bc26320541c441bfa28f99298_2_180x180.png"> <meta name="theme-color" media="all" content="#ffffff"> <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0, user-scalable=yes, viewport-fit=cover"> <link rel="canonical" href="https://discourse.ubuntu.com/t/how-to-attach-your-ubuntu-pro-subscription/46800" /> <link rel="search" type="application/opensearchdescription+xml" href="https://discourse.ubuntu.com/opensearch.xml" title="Ubuntu Community Hub Search"> <link href="/stylesheets/color_definitions_base__2_4df0b5b6908053d16d0c877a7fa322b583f4db7f.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" class="light-scheme"/> <link href="/stylesheets/desktop_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="desktop" /> <link href="/stylesheets/checklist_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="checklist" /> <link href="/stylesheets/discourse-calendar_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="discourse-calendar" /> <link href="/stylesheets/discourse-data-explorer_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="discourse-data-explorer" /> <link href="/stylesheets/discourse-details_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="discourse-details" /> <link href="/stylesheets/discourse-gamification_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="discourse-gamification" /> <link href="/stylesheets/discourse-lazy-videos_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="discourse-lazy-videos" /> <link href="/stylesheets/discourse-local-dates_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="discourse-local-dates" /> <link href="/stylesheets/discourse-narrative-bot_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="discourse-narrative-bot" /> <link href="/stylesheets/discourse-presence_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="discourse-presence" /> <link href="/stylesheets/discourse-solved_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="discourse-solved" /> <link href="/stylesheets/discourse-templates_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="discourse-templates" /> <link href="/stylesheets/markdown-note_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="markdown-note" /> <link href="/stylesheets/poll_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="poll" /> <link href="/stylesheets/spoiler-alert_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="spoiler-alert" /> <link href="/stylesheets/discourse-calendar_desktop_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="discourse-calendar_desktop" /> <link href="/stylesheets/discourse-gamification_desktop_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="discourse-gamification_desktop" /> <link href="/stylesheets/poll_desktop_ca0328f3c15e6bdcab41165f40d567681bececef.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="poll_desktop" /> <link href="/stylesheets/desktop_theme_51_3618fb4255806e97c9b9e1faa6ccc5d4029f5e5b.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="desktop_theme" data-theme-id="51" data-theme-name="discotoc"/> <link href="/stylesheets/desktop_theme_50_61357ff8a1e12ac7fcad6b74566fe569f67101d5.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="desktop_theme" data-theme-id="50" data-theme-name="discourse cookie policy"/> <link href="/stylesheets/desktop_theme_10_9580173011171922db555275ad11ec5b22663414.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="desktop_theme" data-theme-id="10" data-theme-name="ubuntu discourse"/> <link href="/stylesheets/desktop_theme_2_580b90f56065bcedde51e40cfdc741ff0221c030.css?__ws=discourse.ubuntu.com" media="all" rel="stylesheet" data-target="desktop_theme" data-theme-id="2" data-theme-name="default"/> <link href="https://fonts.googleapis.com/css?family=Ubuntu:100,300,400" rel="stylesheet"> <style> body { font-family: 'Ubuntu', sans-serif; font-weight: 400; } h1 { font-weight: 100; } </style> <meta name="google-site-verification" content="grFP-bTinUn8jXfEmhZCV8ccDV1IJG2wexOuguu7z_M"> <script defer="" src="/theme-javascripts/f7a737190fe36b9aee0dd740a1ddde023af282d4.js?__ws=discourse.ubuntu.com" data-theme-id="2" nonce="iOeNiNOyEeDtviPD1YVOKdRsZ"></script> <link href="https://fonts.googleapis.com/css?family=Ubuntu:100,400,700" rel="stylesheet" type="text/css"> <script defer="" src="/theme-javascripts/5fd6ab93349b47da044725d430da846ba195a894.js?__ws=discourse.ubuntu.com" data-theme-id="15" nonce="iOeNiNOyEeDtviPD1YVOKdRsZ"></script> <link rel="alternate nofollow" type="application/rss+xml" title="RSS feed of 'How to attach your Ubuntu Pro subscription'" href="https://discourse.ubuntu.com/t/how-to-attach-your-ubuntu-pro-subscription/46800.rss" /> <meta property="og:site_name" content="Ubuntu Community Hub" /> <meta property="og:type" content="website" /> <meta name="twitter:card" content="summary" /> <meta property="og:image" content="https://ubuntucommunity.s3.us-east-2.amazonaws.com/original/3X/9/0/905b15b7d477513b2af0668c333736b100eef109.svg" /> <meta property="og:url" content="https://discourse.ubuntu.com/t/how-to-attach-your-ubuntu-pro-subscription/46800" /> <meta name="twitter:url" content="https://discourse.ubuntu.com/t/how-to-attach-your-ubuntu-pro-subscription/46800" /> <meta property="og:title" content="How to attach your Ubuntu Pro subscription" /> <meta name="twitter:title" content="How to attach your Ubuntu Pro subscription" /> <meta property="og:description" content="See also: Ubuntu Pro documentation Attaching the Ubuntu Pro subscription to Ubuntu brings you the enterprise lifecycle, including Linux kernel livepatching, access to FIPS-validated packages, and compliance with security profiles such as CIS. This is not required for Ubuntu Pro instances through public clouds such as AWS, Azure or GCP, since these are automatically attached from launch. The following instructions explain how to attach your Ubuntu Pro subscription to your Ubuntu systems. N..." /> <meta name="twitter:description" content="See also: Ubuntu Pro documentation Attaching the Ubuntu Pro subscription to Ubuntu brings you the enterprise lifecycle, including Linux kernel livepatching, access to FIPS-validated packages, and compliance with security profiles such as CIS. This is not required for Ubuntu Pro instances through public clouds such as AWS, Azure or GCP, since these are automatically attached from launch. The following instructions explain how to attach your Ubuntu Pro subscription to your Ubuntu systems. N..." /> <meta property="og:article:section" content="Documentation" /> <meta property="og:article:section:color" content="729FCF" /> <meta property="og:article:section" content="Landscape Docs" /> <meta property="og:article:section:color" content="0088CC" /> <meta property="og:article:tag" content="gcp" /> <meta property="og:article:tag" content="azure" /> <meta property="og:article:tag" content="aws" /> <meta property="article:published_time" content="2024-07-30T19:10:01+00:00" /> <meta property="og:ignore_canonical" content="true" /> <script type="application/ld+json">{"@context":"http://schema.org","@type":"QAPage","name":"How to attach your Ubuntu Pro subscription","mainEntity":{"@type":"Question","name":"How to attach your Ubuntu Pro subscription","text":"See also: <a href=\"https://documentation.ubuntu.com/pro/\">Ubuntu Pro documentation<\/a>\n\nAttaching the <a href=\"https://ubuntu.com/pro\">Ubuntu Pro<\/a> subscription to Ubuntu brings you the <a href=\"https://ubuntu.com/about/release-cycle\">enterprise lifecycle<\/a>, including <a href=\"https://ubuntu.com/security/livepatch\">Linux kernel livepatching<\/a>, access to <a href=\"https://ubuntu.com/security/fips\">FIPS-validated packages<\/a>, and <a href=\"https://ubuntu.com/security/certifications\">compliance with security profiles<\/a> such as CIS. This is not required for Ubuntu Pro instances <a href=\"https://ubuntu.com/public-cloud\">through …<\/a>","upvoteCount":0,"answerCount":0,"datePublished":"2024-07-30T19:10:01.839Z","author":{"@type":"Person","name":"yanisa-hs","url":"https://discourse.ubuntu.com/u/yanisa-hs"}}}</script> </head> <body class="crawler browser-update"> <nav class="p-navigation--secondary"> <div class="u-fixed-width"> <a class="p-navigation--secondary__banner" href="/"> <h5 class="p-navigation--secondary__logo"> Discourse </h5> </a> </div> </nav> <header> <a href="/"> Ubuntu Community Hub </a> </header> <div id="main-outlet" class="wrap" role="main"> <div id="topic-title"> <h1> <a href="/t/how-to-attach-your-ubuntu-pro-subscription/46800">How to attach your Ubuntu Pro subscription</a> </h1> <div class="topic-category" itemscope itemtype="http://schema.org/BreadcrumbList"> <span itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"> <a href="/c/documentation/landscape-docs/90" class="badge-wrapper bullet" itemprop="item"> <span class='badge-category-bg' style='background-color: #729FCF'></span> <span class='badge-category clear-badge'> <span class='category-name' itemprop='name'>Documentation</span> </span> </a> <meta itemprop="position" content="1" /> </span> <span itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"> <a href="/c/documentation/landscape-docs/90" class="badge-wrapper bullet" itemprop="item"> <span class='badge-category-bg' style='background-color: #0088CC'></span> <span class='badge-category clear-badge'> <span class='category-name' itemprop='name'>Landscape Docs</span> </span> </a> <meta itemprop="position" content="2" /> </span> </div> <div class="topic-category"> <div class='discourse-tags list-tags'> <a href='https://discourse.ubuntu.com/tag/gcp' class='discourse-tag' rel="tag">gcp</a>, <a href='https://discourse.ubuntu.com/tag/azure' class='discourse-tag' rel="tag">azure</a>, <a href='https://discourse.ubuntu.com/tag/aws' class='discourse-tag' rel="tag">aws</a> </div> </div> </div> <div itemscope itemtype='http://schema.org/DiscussionForumPosting'> <meta itemprop='headline' content='How to attach your Ubuntu Pro subscription'> <link itemprop='url' href='https://discourse.ubuntu.com/t/how-to-attach-your-ubuntu-pro-subscription/46800'> <meta itemprop='datePublished' content='2024-07-30T19:10:01Z'> <meta itemprop='articleSection' content='Landscape Docs'> <meta itemprop='keywords' content='gcp, azure, aws'> <div itemprop='publisher' itemscope itemtype="http://schema.org/Organization"> <meta itemprop='name' content='Canonical Inc.'> <div itemprop='logo' itemscope itemtype="http://schema.org/ImageObject"> <meta itemprop='url' content='https://ubuntucommunity.s3.us-east-2.amazonaws.com/original/3X/d/1/d1318a905da7b730a81d0b3f393762cb7d478e38.svg'> </div> </div> <div id='post_1' class='topic-body crawler-post'> <div class='crawler-post-meta'> <span class="creator" itemprop="author" itemscope itemtype="http://schema.org/Person"> <a itemprop="url" href='https://discourse.ubuntu.com/u/yanisa-hs'><span itemprop='name'>yanisa-hs</span></a> </span> <link itemprop="mainEntityOfPage" href="https://discourse.ubuntu.com/t/how-to-attach-your-ubuntu-pro-subscription/46800"> <span class="crawler-post-infos"> <time datetime='2024-07-30T19:10:01Z' class='post-time'> July 30, 2024, 7:10pm </time> <meta itemprop='dateModified' content='2025-02-10T22:14:44Z'> <span itemprop='position'>1</span> </span> </div> <div class='post' itemprop='text'> <blockquote> <p>See also: <a href="https://documentation.ubuntu.com/pro/">Ubuntu Pro documentation</a></p> </blockquote> <p>Attaching the <a href="https://ubuntu.com/pro">Ubuntu Pro</a> subscription to Ubuntu brings you the <a href="https://ubuntu.com/about/release-cycle">enterprise lifecycle</a>, including <a href="https://ubuntu.com/security/livepatch">Linux kernel livepatching</a>, access to <a href="https://ubuntu.com/security/fips">FIPS-validated packages</a>, and <a href="https://ubuntu.com/security/certifications">compliance with security profiles</a> such as CIS. This is not required for Ubuntu Pro instances <a href="https://ubuntu.com/public-cloud">through public clouds</a> such as <a href="https://ubuntu.com/aws/pro">AWS</a>, <a href="https://ubuntu.com/azure/pro">Azure</a> or <a href="https://ubuntu.com/gcp/pro">GCP</a>, since these are automatically attached from launch.</p> <p>The following instructions explain how to attach your Ubuntu Pro subscription to your Ubuntu systems.</p> <div class="p-notification"> <div class="p-notification__response"> <p><strong>Note:</strong> Ubuntu Pro isn鈥檛 just for enterprise customers. Anyone can get <a href="https://ubuntu.com/pro">a personal Ubuntu Pro subscription</a> for free on up to 5 machines, or 50 if you are an <a href="https://wiki.ubuntu.com/Membership">official Ubuntu Community member</a>.</p> </div> </div> <h2><a name="p-116889-step-1-install-the-ubuntu-pro-client-1" class="anchor" href="#p-116889-step-1-install-the-ubuntu-pro-client-1"></a>Step 1: Install the Ubuntu Pro Client</h2> <div class="p-notification"> <div class="p-notification__response"> <p><strong>Note:</strong> You must be running Landscape Server 23.03 or above and Landscape Client 23.02 or above to use the Ubuntu Pro Client to attach your Pro subscription to Landscape.</p> </div> </div> <p>This step is necessary for Ubuntu Pro users or holders of personal subscriptions. If you are an Ubuntu Pro user through a public cloud offering, your subscription is already attached and you can skip these instructions.</p> <p>First, make sure that you have the latest version of the Ubuntu Pro Client running. The package used to access the Pro Client (<code>pro</code>) is <code>ubuntu-advantage-tools</code>:</p> <pre data-code-wrap="bash"><code class="lang-bash">sudo apt update && sudo apt install ubuntu-advantage-tools </code></pre> <p>If you already have <code>ubuntu-advantage-tools</code> installed, this install command will upgrade the package to the latest version.</p> <h2><a name="p-116889-step-2-attach-your-subscription-2" class="anchor" href="#p-116889-step-2-attach-your-subscription-2"></a>Step 2: Attach your subscription</h2> <p>To attach your machine to a subscription, run the following command in your terminal:</p> <pre data-code-wrap="bash"><code class="lang-bash">sudo pro attach </code></pre> <p>You should see output like this, giving you a link and a code:</p> <pre data-code-wrap="bash"><code class="lang-bash">ubuntu@test:~$ sudo pro attach Initiating attach operation... Please sign in to your Ubuntu Pro account at this link: https://ubuntu.com/pro/attach And provide the following code: H31JIV </code></pre> <p>Open the link without closing your terminal window.</p> <p>In the field that asks you to enter your code, copy and paste the code shown in the terminal. Then, choose which subscription you want to attach to. By default, the Free Personal Token will be selected.</p> <p>If you have a paid subscription and want to attach to a different token, you may want to log in first so that your additional tokens will appear.</p> <p>Once you have pasted your code and chosen the subscription you want to attach your machine to, click <strong>Submit</strong>.</p> <p>The attach process will then continue in the terminal window, and you should eventually be presented with the following message:</p> <pre><code class="lang-auto">Attaching the machine... Enabling default service esm-apps Updating Ubuntu Pro: ESM Apps package lists Ubuntu Pro: ESM Apps enabled Enabling default service esm-infra Updating Ubuntu Pro: ESM Infra package lists Ubuntu Pro: ESM Infra enabled Enabling default service livepatch Installing snapd snap Installing canonical-livepatch snap Canonical Livepatch enabled This machine is now attached to 'Ubuntu Pro - free personal subscription' </code></pre> <p>When the machine has successfully been attached, you will also see a summary of which services are enabled and information about your subscription.</p> <p>Available services can be enabled or disabled on the command line with <code>pro enable <service name></code> and <code>pro disable <service name></code> after you have attached.</p> <h2><a name="p-116889-related-topics-3" class="anchor" href="#p-116889-related-topics-3"></a>Related topics</h2> <ul> <li><a href="https://canonical-ubuntu-pro-client.readthedocs-hosted.com/en/latest/">Ubuntu Pro Client documentation</a></li> <li><a href="https://canonical-ubuntu-pro-client.readthedocs-hosted.com/en/latest/tutorials/basic_commands.html">Ubuntu Pro Client documentation on basic commands</a></li> </ul> </div> <div itemprop="interactionStatistic" itemscope itemtype="http://schema.org/InteractionCounter"> <meta itemprop="interactionType" content="http://schema.org/LikeAction"/> <meta itemprop="userInteractionCount" content="0" /> <span class='post-likes'></span> </div> <div class='crawler-linkback-list' itemscope itemtype='http://schema.org/ItemList'> <div itemprop='itemListElement' itemscope itemtype='http://schema.org/ListItem'> <a itemprop='url' href="https://discourse.ubuntu.com/t/how-to-enable-landscape-in-the-ubuntu-pro-client/46870">How to enable Landscape in the Ubuntu Pro Client</a> <meta itemprop='position' content='14'> </div> <div itemprop='itemListElement' itemscope itemtype='http://schema.org/ListItem'> <a itemprop='url' href="https://discourse.ubuntu.com/t/how-to-install-landscape-server-with-quickstart-mode/23082">How to install Landscape Server with quickstart mode</a> <meta itemprop='position' content='15'> </div> <div itemprop='itemListElement' itemscope itemtype='http://schema.org/ListItem'> <a itemprop='url' href="https://discourse.ubuntu.com/t/how-to-install-landscape-manually/23085">How to install Landscape manually</a> <meta itemprop='position' content='16'> </div> <div itemprop='itemListElement' itemscope itemtype='http://schema.org/ListItem'> <a itemprop='url' href="https://discourse.ubuntu.com/t/landscape-how-to-guides/42219">Landscape how-to guides</a> <meta itemprop='position' content='17'> </div> <div itemprop='itemListElement' itemscope itemtype='http://schema.org/ListItem'> <a itemprop='url' href="https://discourse.ubuntu.com/t/landscape-documentation/23070">Landscape Documentation</a> <meta itemprop='position' content='18'> </div> </div> </div> </div> </div> <footer class="container wrap"> <nav class='crawler-nav'> <ul> <li itemscope itemtype='http://schema.org/SiteNavigationElement'> <span itemprop='name'> <a href='/' itemprop="url">Home </a> </span> </li> <li itemscope itemtype='http://schema.org/SiteNavigationElement'> <span itemprop='name'> <a href='/categories' itemprop="url">Categories </a> </span> </li> <li itemscope itemtype='http://schema.org/SiteNavigationElement'> <span itemprop='name'> <a href='/guidelines' itemprop="url">Guidelines </a> </span> </li> <li itemscope itemtype='http://schema.org/SiteNavigationElement'> <span itemprop='name'> <a href='https://www.ubuntu.com/legal' itemprop="url">Terms of Service </a> </span> </li> <li itemscope itemtype='http://schema.org/SiteNavigationElement'> <span itemprop='name'> <a href='https://www.ubuntu.com/legal/terms-and-policies/privacy-policy' itemprop="url">Privacy Policy </a> </span> </li> </ul> </nav> <p class='powered-by-link'>Powered by <a href="https://www.discourse.org">Discourse</a>, best viewed with JavaScript enabled</p> </footer> <footer class="d-footer"> <div class="wrap"> <div class="contents"> <p>漏 2024 Canonical Ltd.</p> <div class="d-footer__links"> <a href="https://ubuntu.com/legal">Legal information</a> <a href="https://ubuntu.com/legal/data-privacy" target="_blank">Privacy policy</a> <a href="#" class="js-revoke-cookie-manager">Manage your tracker settings</a> </div> </div> </div> </footer> <div class="buorg"><div>Unfortunately, <a href="https://www.discourse.org/faq/#browser">your browser is unsupported</a>. Please <a href="https://browsehappy.com">switch to a supported browser</a> to view rich content, log in and reply.</div></div> </body> </html>