From 621763b8a5e4e28bccf7807bf562a44804e01eaf Mon Sep 17 00:00:00 2001 From: Timothée Ravier Date: Nov 20 2022 17:15:15 +0000 Subject: Add ostree specific page and notes for #811 Fixes: https://pagure.io/fedora-docs/release-notes/issue/811 --- diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc index 083652d..5748e59 100644 --- a/modules/release-notes/nav.adoc +++ b/modules/release-notes/nav.adoc @@ -13,6 +13,7 @@ include::{partialsdir}/entities.adoc[] *** xref:sysadmin/System_Utilities.adoc[System Utilities] *** xref:sysadmin/Printing_Scanning.adoc[Printing and Scanning] *** xref:sysadmin/Mail_Servers.adoc[Mail Servers] +*** xref:sysadmin/Ostree.adoc[Ostree based variants] ** xref:desktop/Desktop_index.adoc[Desktop Users] *** xref:desktop/I18n.adoc[Internationalization] ** xref:developers/Developers.adoc[Developers] diff --git a/modules/release-notes/pages/sysadmin/Ostree.adoc b/modules/release-notes/pages/sysadmin/Ostree.adoc new file mode 100644 index 0000000..42afb44 --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Ostree.adoc @@ -0,0 +1,28 @@ +include::{partialsdir}/entities.adoc[] + += Changes for ostree based variants of Fedora + +This page regroups changes that only apply to ostree/rpm-ostree based variants of Fedora, such as Fedora CoreOS, Fedora IoT, Fedora Silverblue and Fedora Kinoite. + +[[fedora-coreos-major-changes]] +== Fedora CoreOS major changes + +Major changes for Fedora CoreOS are list in the https://docs.fedoraproject.org/en-US/fedora-coreos/major-changes/[Major Changes page] in the https://docs.fedoraproject.org/en-US/fedora-coreos/[Fedora CoreOS documentation]. + +[[readonly-sysroot-ostree-desktopsl]] +== `/sysroot` mounted read only + +On rpm-ostree based systems, the real root (the root directory of the root partition on the disk) is mounted under the `/sysroot` path. +By default it contains the state of the system (the content of `/var` and `/etc`) as well as the system versions themselves (each versioned copy of `/usr`) in the ostree repository (`/ostree/repo`). + +Users and administrators are not expected to directly interact with the content available there and should instead use the interface offered by rpm-ostree, GNOME Software or soon Plasma Discover to manage their system. + +Thus `/sysroot` is now mounted read only starting with this release. + +New installations of all three variants will have `/sysroot` read only by default. + +Existing installations of Fedora Silverblue and Fedora Kinoite will be migrated on the first boot to Fedora 37 and will have `/sysroot` read only on the next boot. + +Fedora CoreOS has already made this change in a previous release (https://github.com/coreos/fedora-coreos-tracker/issues/1232[fedora-coreos-tracker#1232]). + +See the https://fedoraproject.org/wiki/Changes/Silverblue_Kinoite_readonly_sysroot[Fedora change page] for more details.