From 7044e36ef2065f65821233dca66508529a04b707 Mon Sep 17 00:00:00 2001 From: Erwan Le Floch <90708860+erlefloch@users.noreply.github.com> Date: Mon, 17 Jul 2023 01:53:57 +0200 Subject: [PATCH 1/4] Add LUKS keyboard issue to the known limitations Adding a small paragraph about this issue, as proposed in https://github.com/fedora-silverblue/issue-tracker/issues/3#issuecomment-1637154862 --- modules/ROOT/pages/installation.adoc | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/modules/ROOT/pages/installation.adoc b/modules/ROOT/pages/installation.adoc index 14f2afe..709ec11 100644 --- a/modules/ROOT/pages/installation.adoc +++ b/modules/ROOT/pages/installation.adoc @@ -23,6 +23,11 @@ If you are uncertain about this, {variant-name} can also be tested in a virtual It is possible to make {variant-name} work for both dual boot and manual partitioning, and some guidance is provided on manual partitioning below. However, there are hazards involved in both cases, and you should only attempt to use these features if you have done the necessary research, and are confident that you can overcome any issues that you might encounter. +*The keyboard layout selected during installation is not used for the LUKS unlock screen of {variant-name}.* + +Regardless of your selection during the installation process, the keyboard layout available for the LUKS unlock screen will default to `en-US` (English - United States of America). +There are some workarounds available, as described in the https://bugzilla.redhat.com/show_bug.cgi?id=1890085[bug] opened in 2020 on the Red Hat bugzilla, or on the https://github.com/fedora-silverblue/issue-tracker/issues/3[issue #3] in the Fedora Silverblue issue tracker on GitHub. + [[getting-silverblue]] == Getting {variant-name} From f59d92c9dea54838cf665bd10d150a8a0d334809 Mon Sep 17 00:00:00 2001 From: Erwan Le Floch <90708860+erlefloch@users.noreply.github.com> Date: Mon, 17 Jul 2023 15:03:28 +0200 Subject: [PATCH 2/4] Update modules/ROOT/pages/installation.adoc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Timothée Ravier --- modules/ROOT/pages/installation.adoc | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/installation.adoc b/modules/ROOT/pages/installation.adoc index 709ec11..215be24 100644 --- a/modules/ROOT/pages/installation.adoc +++ b/modules/ROOT/pages/installation.adoc @@ -26,7 +26,10 @@ However, there are hazards involved in both cases, and you should only attempt t *The keyboard layout selected during installation is not used for the LUKS unlock screen of {variant-name}.* Regardless of your selection during the installation process, the keyboard layout available for the LUKS unlock screen will default to `en-US` (English - United States of America). -There are some workarounds available, as described in the https://bugzilla.redhat.com/show_bug.cgi?id=1890085[bug] opened in 2020 on the Red Hat bugzilla, or on the https://github.com/fedora-silverblue/issue-tracker/issues/3[issue #3] in the Fedora Silverblue issue tracker on GitHub. +You can workaround this issue by running the following command on the first boot after the installation: + rpm-ostree initramfs-etc --track=/etc/vconsole.conf + +See https://bugzilla.redhat.com/show_bug.cgi?id=1890085[bug #1890085] (Red Hat Bugzilla) and https://github.com/fedora-silverblue/issue-tracker/issues/3[issue #3] (Fedora Silverblue issue tracker) for details. [[getting-silverblue]] == Getting {variant-name} From 5545805b6aa52ad3cef1ba99abc659c4b9a63e5b Mon Sep 17 00:00:00 2001 From: Erwan Le Floch <90708860+erlefloch@users.noreply.github.com> Date: Mon, 17 Jul 2023 15:19:23 +0200 Subject: [PATCH 3/4] add practical tip add practical tip using the gnome disks app --- modules/ROOT/pages/installation.adoc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/installation.adoc b/modules/ROOT/pages/installation.adoc index 215be24..793a3fd 100644 --- a/modules/ROOT/pages/installation.adoc +++ b/modules/ROOT/pages/installation.adoc @@ -27,7 +27,9 @@ However, there are hazards involved in both cases, and you should only attempt t Regardless of your selection during the installation process, the keyboard layout available for the LUKS unlock screen will default to `en-US` (English - United States of America). You can workaround this issue by running the following command on the first boot after the installation: - rpm-ostree initramfs-etc --track=/etc/vconsole.conf + `rpm-ostree initramfs-etc --track=/etc/vconsole.conf`. + +To avoid struggling when having to type the LUKS passphrase for the first time, you could set during installation a disk encryption passphrase that is easy to type with the `en-US` keyboard layout, and then changing it to the passphrase that you actually want through the GNOME https://apps.gnome.org/en-GB/app/org.gnome.DiskUtility[Disks] app. See https://bugzilla.redhat.com/show_bug.cgi?id=1890085[bug #1890085] (Red Hat Bugzilla) and https://github.com/fedora-silverblue/issue-tracker/issues/3[issue #3] (Fedora Silverblue issue tracker) for details. From abce642b89d44f36f6443fc3afcbf370f2ed39ce Mon Sep 17 00:00:00 2001 From: Erwan Le Floch <90708860+erlefloch@users.noreply.github.com> Date: Mon, 17 Jul 2023 15:22:47 +0200 Subject: [PATCH 4/4] Update installation.adoc minor grammar fix --- modules/ROOT/pages/installation.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/installation.adoc b/modules/ROOT/pages/installation.adoc index 793a3fd..a667325 100644 --- a/modules/ROOT/pages/installation.adoc +++ b/modules/ROOT/pages/installation.adoc @@ -29,7 +29,7 @@ Regardless of your selection during the installation process, the keyboard layou You can workaround this issue by running the following command on the first boot after the installation: `rpm-ostree initramfs-etc --track=/etc/vconsole.conf`. -To avoid struggling when having to type the LUKS passphrase for the first time, you could set during installation a disk encryption passphrase that is easy to type with the `en-US` keyboard layout, and then changing it to the passphrase that you actually want through the GNOME https://apps.gnome.org/en-GB/app/org.gnome.DiskUtility[Disks] app. +To avoid struggling when having to type the LUKS passphrase for the first time, you could set during installation a disk encryption passphrase that is easy to type with the `en-US` keyboard layout, and then change it to the passphrase that you actually want through the GNOME https://apps.gnome.org/en-GB/app/org.gnome.DiskUtility[Disks] app. See https://bugzilla.redhat.com/show_bug.cgi?id=1890085[bug #1890085] (Red Hat Bugzilla) and https://github.com/fedora-silverblue/issue-tracker/issues/3[issue #3] (Fedora Silverblue issue tracker) for details.