Skip to content

chrony: add useful details on bootstrap server cert#704

Open
hector-cao wants to merge 9 commits into
mainfrom
hectorcao/add-chrony-nts-cert-info
Open

chrony: add useful details on bootstrap server cert#704
hector-cao wants to merge 9 commits into
mainfrom
hectorcao/add-chrony-nts-cert-info

Conversation

@hector-cao
Copy link
Copy Markdown
Contributor

We had a bug report related to the chrony NTS certificate:

https://bugs.launchpad.net/ubuntu/+source/chrony/+bug/2152270

I think it is useful to have some details about the certificate used for the bootstrap server.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the chrony client how-to to add more detail about Ubuntu’s Network Time Security (NTS) defaults, with emphasis on how the ntp-bootstrap.ubuntu.com bootstrap server’s certificate trust is configured.

Changes:

  • Expands the NTS section to describe the default Ubuntu NTS pool configuration file and options (nts, prefer, certset).
  • Adds an explanation of the bootstrap server’s role for large clock offsets and how its certificate trust is configured via ntstrustedcerts.
  • Adds openssl examples and certificate excerpts to illustrate differences between public-CA-issued and privately trusted certificates.
Comments suppressed due to low confidence (1)

docs/how-to/networking/chrony-client.md:133

  • “issuer as ubuntu, which is not a Certificate Authority (CA)” is misleading: an issuer name doesn’t determine whether it’s a CA, and in this case it’s effectively a private CA (not publicly trusted) used to sign the bootstrap server certificate. Suggest rewording to avoid implying the certificate is invalid, and instead explain it’s not signed by a public CA like Let’s Encrypt.
shows the issuer as `ubuntu`, which is not a Certificate Authority (CA), compared with `Let's Encrypt`,
which is a CA.

Comment thread docs/how-to/networking/chrony-client.md Outdated
Comment thread docs/how-to/networking/chrony-client.md
Comment thread docs/how-to/networking/chrony-client.md Outdated
Comment thread docs/how-to/networking/chrony-client.md Outdated
Comment thread docs/how-to/networking/chrony-client.md Outdated
Comment thread docs/how-to/networking/chrony-client.md Outdated
hector-cao and others added 5 commits May 20, 2026 13:55
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Comment thread docs/how-to/networking/chrony-client.md Outdated
Comment thread docs/how-to/networking/chrony-client.md Outdated
Comment thread docs/how-to/networking/chrony-client.md Outdated
Comment thread docs/how-to/networking/chrony-client.md Outdated
@hector-cao hector-cao force-pushed the hectorcao/add-chrony-nts-cert-info branch from 4a552f8 to 3f5da75 Compare May 20, 2026 13:48
Comment thread docs/how-to/networking/chrony-client.md Outdated
@hector-cao hector-cao force-pushed the hectorcao/add-chrony-nts-cert-info branch from 3f5da75 to d707d14 Compare May 20, 2026 13:53
@hector-cao hector-cao force-pushed the hectorcao/add-chrony-nts-cert-info branch from d707d14 to 048b2ce Compare May 20, 2026 13:56
@panlinux
Copy link
Copy Markdown
Contributor

While at it, could you also please fix the mention of a CA in the docs further down? It's in this "note":

:::{note}
  A new CA is installed in `/etc/chrony/nts-bootstrap-ubuntu.crt` that is
  used specifically for the Ubuntu NTS bootstrap server, needed for when the
  clock is too far off. This is added to certificate set ID "1", and defined
  via `/etc/chrony/conf.d/ubuntu-nts.conf`.
:::

I propose that should say:

:::{note}
 The certificate for ntp-bootstrap.ubuntu.com is installed in
 `/etc/chrony/nts-bootstrap-ubuntu.crt` and is used specifically for the
 Ubuntu NTS bootstrap server, needed ... (the rest remains as is)

@hector-cao
Copy link
Copy Markdown
Contributor Author

While at it, could you also please fix the mention of a CA in the docs further down? It's in this "note":

:::{note}
  A new CA is installed in `/etc/chrony/nts-bootstrap-ubuntu.crt` that is
  used specifically for the Ubuntu NTS bootstrap server, needed for when the
  clock is too far off. This is added to certificate set ID "1", and defined
  via `/etc/chrony/conf.d/ubuntu-nts.conf`.
:::

I propose that should say:

:::{note}
 The certificate for ntp-bootstrap.ubuntu.com is installed in
 `/etc/chrony/nts-bootstrap-ubuntu.crt` and is used specifically for the
 Ubuntu NTS bootstrap server, needed ... (the rest remains as is)

updated; thanks

Copy link
Copy Markdown
Contributor

@panlinux panlinux left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants