docs: update authd availability for Ubuntu 26.04 LTS archive by nooreldeenmansour · Pull Request #1373 · canonical/authd

nooreldeenmansour · 2026-03-31T11:08:55Z

UDENG-9585

docs/howto/install-authd.md

docs/reference/cloud-init-deploy.md

SECURITY.md

adombeck · 2026-04-01T10:18:19Z

docs/howto/install-authd.md

+**Ubuntu 26.04 LTS (Resolute) and later:** `authd` is available directly from the Ubuntu archive.

-To add this PPA to your system's software sources, run the following command:
+**Ubuntu 24.04 LTS (Noble):** `authd` must be installed from the [stable PPA](https://launchpad.net/~ubuntu-enterprise-desktop/+archive/ubuntu/authd):


I doubt that mentioning the release names are a benefit to our users, I would omit them to make it look a bit cleaner. Also, very nitpicky, but for consistency with how it's done above on the same page, the : should not be bold.

Suggested change

**Ubuntu 26.04 LTS (Resolute) and later:** `authd` is available directly from the Ubuntu archive.

To add this PPA to your system's software sources, run the following command:

**Ubuntu 24.04 LTS (Noble):** `authd` must be installed from the [stable PPA](https://launchpad.net/~ubuntu-enterprise-desktop/+archive/ubuntu/authd):

**Ubuntu 26.04 LTS and later**: `authd` is available directly from the Ubuntu archive.

**Ubuntu 24.04 LTS**: `authd` must be installed from the [stable PPA](https://launchpad.net/~ubuntu-enterprise-desktop/+archive/ubuntu/authd):

Our convention is that we can mention the release name or not, but that we should always mention if it is an LTS.

Ok, then nevermind

But I agree: I don't think we need to use the release name. Just to be clear.

adombeck · 2026-04-01T10:27:40Z

docs/reference/landscape-deploy.md

+:::{note}
+On Ubuntu 24.04 LTS (Noble), `authd` is not in the Ubuntu archive. Add the following
+line at the start of your script, before `apt-get install authd`:
+
+```shell
+add-apt-repository -y ppa:ubuntu-enterprise-desktop/authd
+```
+
+On Ubuntu 26.04 LTS (Resolute) and later, this step is not required.
+:::
+


I like this note, I think it looks better than the

Ubuntu 26.04 LTS (Resolute) and later: [...]
Ubuntu 24.04 LTS (Noble): [...]

used in install-authd.md and cloud-init-deploy.md. Maybe we can use a similar note there too.

However, one aspect that's not ideal is that we don't tell users of 25.10 what to do (they also need the PPA). Probably not worth spending much time on since 25.10 will be end-of-life in July.

we don't tell users of 25.10 what to do

True, although it is somewhat implicit in the wording (if it's required for 24.04, but not required for 26.04, it probably is required for the one in between). Given what you say about its EOL, I would think it's OK for now, or at least until someone asks.

I like this note

Me too. A few things though:

I would consider only wrapping information about Ubuntu 24.04 LTS and the relevant command in the note block (treat 26.04 as the default). In this section, I think it can just start with "For Ubuntu 26.04 LTS, install the authd deb and the broker snap:" so that the line on Resolute in the block is not needed.

I think it's useful to have a labelled note block in this case. Something like "Before installing on 24.04", "Additional step for 24.04", or "PPA required for installing on Ubuntu 24.04". To do this, use {admonition} Your label and add :class: note as the first line within the block.

As already mentioned, we probably don't need to use the release names. I'm not sure it adds much value in this context.

(edit: adding suggestions)

edibotopic · 2026-04-01T10:30:32Z

Thanks @nooreldeenmansour . I was planning to do this as a part of UDENG-9498, but will review this PR instead.

nooreldeenmansour · 2026-04-01T10:46:17Z

@edibotopic I wasn’t aware of that ticket. I’ll make sure to coordinate and check for any related documentation work beforehand going forward.

edibotopic

Great, timely work @nooreldeenmansour !

I've added some suggestions for you to consider.

edibotopic · 2026-04-01T12:23:33Z

docs/howto/install-authd.md

 ## System requirements

-* Distribution: Ubuntu Desktop 24.04 LTS or Ubuntu Server 24.04 LTS
+* Distribution: Ubuntu Desktop 24.04 LTS or later, or Ubuntu Server 24.04 LTS or later


Suggested change

* Distribution: Ubuntu Desktop 24.04 LTS or later, or Ubuntu Server 24.04 LTS or later

* Ubuntu: Desktop or Server editions

* Version: Ubuntu 24.04 LTS or later

I find this line a little messy (indicated by three uses of "or" in sequence).

My suggestion is to split Distribution into two items: Ubuntu and Version.

I've applied your suggestion, but what about using the word Release instead of Version

We perhaps can drop the word Ubuntu from the second bullet-point, as it exists in the bullet point above it. What do you think?

No problem using Release instead of Version.

And, agreed: we can drop "Ubuntu" from the second bullet.

edibotopic · 2026-04-01T12:26:34Z

docs/howto/install-authd.md

 ## Install authd

-You can install authd from the [stable PPA](https://launchpad.net/~ubuntu-enterprise-desktop/+archive/ubuntu/authd).
+**Ubuntu 26.04 LTS (Resolute) and later:** `authd` is available directly from the Ubuntu archive.


Suggested change

**Ubuntu 26.04 LTS (Resolute) and later:** `authd` is available directly from the Ubuntu archive.

On Ubuntu 26.04 LTS, `authd` is available directly from the Ubuntu archive.

I don't think we need the "and later" here? What is "later" currently?

I also don't think we need the additional formatting or the release name.

Should I remove the and later from the SECURITY.md file too?

We provide security updates for the latest version of `authd` on each supported Ubuntu LTS release. **Ubuntu 26.04 LTS and later**: `authd` is available directly from the Ubuntu archive. **Ubuntu 24.04 LTS and earlier supported LTS releases**: `authd` is not in the Ubuntu archive and must be installed using the stable PPA.

One could argue that for upcoming releases, they will be in archive, so we won't have to update it for each LTS release, unless we wish to make it more explicit. What do you think?

My initial thought was that a "later" currently doesn't exist.

However, this can be interpreted as a kind of commitment, and in that sense it's OK, as long as we fulfill that commitment.

So we can just leave it as is.

edibotopic · 2026-04-01T12:27:34Z

docs/howto/install-authd.md

+**Ubuntu 26.04 LTS (Resolute) and later:** `authd` is available directly from the Ubuntu archive.

-To add this PPA to your system's software sources, run the following command:
+**Ubuntu 24.04 LTS (Noble):** `authd` must be installed from the [stable PPA](https://launchpad.net/~ubuntu-enterprise-desktop/+archive/ubuntu/authd):


As mentioned in https://github.com/canonical/authd/pull/1373/changes#r3021197348, consider wrapping the 24.04 details in a note block.

edibotopic · 2026-04-01T12:28:23Z

docs/reference/cloud-init-deploy.md

-Add the authd PPA to the system's software sources and install authd:
+**Ubuntu 26.04 LTS (Resolute) and later:** `authd` is available directly from the Ubuntu archive:
+
+```yaml
+packages:
+  - authd
+```
+
+**Ubuntu 24.04 LTS (Noble):** `authd` must be installed from the stable PPA. Add it to the system's software sources:


See https://github.com/canonical/authd/pull/1373/changes#r3021197348

edibotopic · 2026-04-01T12:29:08Z

docs/reference/landscape-deploy.md

@@ -34,14 +34,24 @@ CLIENT_ID=<CLIENT_ID>

 Install the authd deb and the broker snap:


Suggested change

Install the authd deb and the broker snap:

For Ubuntu 26.04 LTS, install the authd deb and the broker snap from the archive:

edibotopic · 2026-04-01T12:32:32Z

docs/reference/landscape-deploy.md

+:::{note}
+On Ubuntu 24.04 LTS (Noble), `authd` is not in the Ubuntu archive. Add the following
+line at the start of your script, before `apt-get install authd`:


Suggested change

:::{note}

On Ubuntu 24.04 LTS (Noble), `authd` is not in the Ubuntu archive. Add the following

line at the start of your script, before `apt-get install authd`:

:::{admonition} Add PPA before installing on Ubuntu 24.04

Add the following

line at the start of your script, before `apt-get install authd`, to add the PPA:

docs/reference/landscape-deploy.md

edibotopic · 2026-04-01T12:36:44Z

SECURITY.md

-If you are unsure of your version, please run the following command in a terminal and check which PPA `authd` is installed from:
+**Ubuntu 26.04 LTS (Resolute) and later:** `authd` is available directly from the Ubuntu archive.
+
+**Ubuntu 24.04 LTS (Noble) and earlier supported LTS releases:** `authd` is not in the Ubuntu archive and must be installed via the stable PPA.


Suggested change

**Ubuntu 24.04 LTS (Noble) and earlier supported LTS releases:** `authd` is not in the Ubuntu archive and must be installed via the stable PPA.

**Ubuntu 24.04 LTS and earlier supported LTS releases:** `authd` is not in the Ubuntu archive and must be installed using the stable PPA.

Avoid Latinisms when there is a straightforward alternative.

edibotopic · 2026-04-01T12:36:51Z

SECURITY.md

+We provide security updates for the latest version of `authd` on each supported Ubuntu LTS release.

-If you are unsure of your version, please run the following command in a terminal and check which PPA `authd` is installed from:
+**Ubuntu 26.04 LTS (Resolute) and later:** `authd` is available directly from the Ubuntu archive.


Suggested change

**Ubuntu 26.04 LTS (Resolute) and later:** `authd` is available directly from the Ubuntu archive.

**Ubuntu 26.04 LTS and later:** `authd` is available directly from the Ubuntu archive.

edibotopic · 2026-04-01T12:37:20Z

SECURITY.md

+
+An [edge PPA](https://launchpad.net/~ubuntu-enterprise-desktop/+archive/ubuntu/authd-edge) provides the latest development builds, but is not recommended for production use and does not receive security support.
+
+If you are unsure of your version, please run the following command in a terminal and check which channel `authd` is installed from:


Suggested change

If you are unsure of your version, please run the following command in a terminal and check which channel `authd` is installed from:

If you are unsure of your version, please run the following command in a terminal to check which channel `authd` is installed from:

edibotopic · 2026-04-01T12:57:02Z

@nooreldeenmansour @adombeck --- I'm wondering should we also look at this page: https://canonical-ubuntu-documentation-library--1373.com.readthedocs.build/authd/1373/howto/changing-versions/ .

Specifically the section: Switch authd to the edge PPA.

This section made more sense when the default install was the stable PPA. But now it is only mentioned as the install option for 24.04. The instructions wouldn't be appropriate for someone switching back and forth between the 26.04 package and the edge PPA.

We could reword/rewrite it slightly to be more general, covering switching between stable and edge for PPA users on 24.04 (if we need to include that) but also using the edge PPA instead of the archive package (for those who are interested). We would eventually keep the focus on the archive package in install.md, for example, but be able to point to this changing-versions.md where necessary.

Related to #1341

nooreldeenmansour force-pushed the update-installation-instructions branch from 8c3fcaf to c5d3e84 Compare March 31, 2026 11:19

nooreldeenmansour changed the title ~~docs: update installation instructions to include archive for resolute~~ docs: update authd availability for Ubuntu 26.04 LTS archive Mar 31, 2026

nooreldeenmansour force-pushed the update-installation-instructions branch 2 times, most recently from 6893154 to a4f8299 Compare March 31, 2026 11:46

adombeck reviewed Apr 1, 2026

View reviewed changes

docs/howto/install-authd.md Outdated Show resolved Hide resolved

docs/reference/cloud-init-deploy.md Outdated Show resolved Hide resolved

SECURITY.md Outdated Show resolved Hide resolved

adombeck requested a review from edibotopic April 1, 2026 10:11

nooreldeenmansour force-pushed the update-installation-instructions branch from 0b74a4d to 140bc6d Compare April 1, 2026 10:16

adombeck reviewed Apr 1, 2026

View reviewed changes

edibotopic requested changes Apr 1, 2026

View reviewed changes

nooreldeenmansour force-pushed the update-installation-instructions branch from a88f378 to 452468b Compare April 1, 2026 16:00

docs: update authd availability for Ubuntu 26.04 LTS archive

48b6dba

nooreldeenmansour force-pushed the update-installation-instructions branch from 452468b to 48b6dba Compare April 2, 2026 10:21

	* Distribution: Ubuntu Desktop 24.04 LTS or later, or Ubuntu Server 24.04 LTS or later
	* Ubuntu: Desktop or Server editions
	* Version: Ubuntu 24.04 LTS or later

	Ubuntu 26.04 LTS (Resolute) and later: `authd` is available directly from the Ubuntu archive.
	On Ubuntu 26.04 LTS, `authd` is available directly from the Ubuntu archive.

		@@ -34,14 +34,24 @@ CLIENT_ID=<CLIENT_ID>

		Install the authd deb and the broker snap:

	Install the authd deb and the broker snap:
	For Ubuntu 26.04 LTS, install the authd deb and the broker snap from the archive:

	Ubuntu 24.04 LTS (Noble) and earlier supported LTS releases: `authd` is not in the Ubuntu archive and must be installed via the stable PPA.
	Ubuntu 24.04 LTS and earlier supported LTS releases: `authd` is not in the Ubuntu archive and must be installed using the stable PPA.

	Ubuntu 26.04 LTS (Resolute) and later: `authd` is available directly from the Ubuntu archive.
	Ubuntu 26.04 LTS and later: `authd` is available directly from the Ubuntu archive.


		An [edge PPA](https://launchpad.net/~ubuntu-enterprise-desktop/+archive/ubuntu/authd-edge) provides the latest development builds, but is not recommended for production use and does not receive security support.

		If you are unsure of your version, please run the following command in a terminal and check which channel `authd` is installed from:

Conversation

nooreldeenmansour commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

adombeck Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

edibotopic Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

edibotopic commented Apr 1, 2026

Uh oh!

nooreldeenmansour commented Apr 1, 2026

Uh oh!

edibotopic left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

edibotopic commented Apr 1, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

nooreldeenmansour commented Mar 31, 2026 •

edited

Loading

adombeck Apr 1, 2026 •

edited

Loading

edibotopic Apr 1, 2026 •

edited

Loading