Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add LUKS keyboard issue to the known limitations #156

Merged
merged 4 commits into from
Jul 17, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions modules/ROOT/pages/installation.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,16 @@ 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).
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 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.

[[getting-silverblue]]
== Getting {variant-name}

Expand Down