Skip to content

Commit 40ef1e5

Browse files
committed
fde.md: Clarifying base-system installation.
Making clearer to the reader that the actual installation command should use the appropriate URL, also separating GRUB installation and configuration from the base-system section to make the installation procedures (chroot and fde) more consistent, making easier to mention one single source to avoid repetition.
1 parent 728e3fd commit 40ef1e5

File tree

1 file changed

+28
-43
lines changed

1 file changed

+28
-43
lines changed

src/installation/guides/fde.md

+28-43
Original file line numberDiff line numberDiff line change
@@ -122,27 +122,9 @@ On a UEFI system, the EFI system partition also needs to be mounted.
122122

123123
Before we enter the chroot to finish up configuration, we do the actual install.
124124

125-
`xbps-install` might ask you to [verify the RSA
126-
keys](../../xbps/troubleshooting/common-issues.md#verifying-rsa-keys) for the
127-
packages you are installing.
128-
129-
```
130-
# xbps-install -Sy -R https://alpha.de.repo.voidlinux.org/current -r /mnt base-system lvm2 cryptsetup grub
131-
[*] Updating `https://alpha.de.repo.voidlinux.org/current/x86_64-repodata' ...
132-
x86_64-repodata: 1661KB [avg rate: 2257KB/s]
133-
`https://alpha.de.repo.voidlinux.org/current' repository has been RSA signed by "Void Linux"
134-
Fingerprint: 60:ae:0c:d6:f0:95:17:80:bc:93:46:7a:89:af:a3:2d
135-
Do you want to import this public key? [Y/n] y
136-
130 packages will be downloaded:
137-
...
138-
```
139-
140-
UEFI systems will have a slightly different package selection. The installation
141-
command for a UEFI system will be as follows.
142-
143-
```
144-
# xbps-install -Sy -R https://alpha.de.repo.voidlinux.org/current -r /mnt base-system cryptsetup grub-x86_64-efi lvm2
145-
```
125+
Follow the instructions on [Base Installation](chroot.md#base-installation) to
126+
install the `base-system` and, additionally, the other important packages we
127+
need in this specific case, those are: `lvm2` and `cryptsetup`.
146128

147129
When it's done, we can enter the `chroot` and finish up the configuration.
148130

@@ -174,26 +156,6 @@ UEFI systems will also have an entry for the EFI system partition.
174156
/dev/sda1 /boot/efi vfat defaults 0 0
175157
```
176158

177-
Next, configure GRUB to be able to unlock the filesystem. Add the following line
178-
to `/etc/default/grub`:
179-
180-
```
181-
GRUB_ENABLE_CRYPTODISK=y
182-
```
183-
184-
Next, the kernel needs to be configured to find the encrypted device. First,
185-
find the UUID of the device.
186-
187-
```
188-
# blkid -o value -s UUID /dev/sda1
189-
135f3c06-26a0-437f-a05e-287b036440a4
190-
```
191-
192-
Edit the `GRUB_CMDLINE_LINUX_DEFAULT=` line in `/etc/default/grub` and add
193-
`rd.lvm.vg=voidvm rd.luks.uuid=<UUID>` to it. Make sure the UUID matches the one
194-
for the `sda1` device found in the output of the
195-
[blkid(8)](https://man.voidlinux.org/blkid.8) command above.
196-
197159
And now to avoid having to enter the password twice on boot, a key will be
198160
configured to automatically unlock the encrypted volume on boot. First, generate
199161
a random key.
@@ -233,12 +195,35 @@ a new file at `/etc/dracut.conf.d/10-crypt.conf` with the following line:
233195
install_items+=" /boot/volume.key /etc/crypttab "
234196
```
235197

236-
Next, install the boot loader to the disk.
198+
Now we will configure our bootloader, see the instructions on [Installing
199+
GRUB](chroot.md#installing-grub) to install the correct GRUB package for your
200+
system, but do not install it on the disk just yet (with `grub-install`) as we
201+
will need to modify it's configuration before doing so.
202+
203+
After installing the correct GRUB package, configure GRUB to be able to unlock
204+
the filesystem. Add the following line to `/etc/default/grub`:
205+
206+
```
207+
GRUB_ENABLE_CRYPTODISK=y
208+
```
209+
210+
Next, the kernel needs to be configured to find the encrypted device. First,
211+
find the UUID of the device.
237212

238213
```
239-
# grub-install /dev/sda
214+
# blkid -o value -s UUID /dev/sda1
215+
135f3c06-26a0-437f-a05e-287b036440a4
240216
```
241217

218+
Edit the `GRUB_CMDLINE_LINUX_DEFAULT=` line in `/etc/default/grub` and add
219+
`rd.lvm.vg=voidvm rd.luks.uuid=<UUID>` to it. Make sure the UUID matches the one
220+
for the `sda1` device found in the output of the
221+
[blkid(8)](https://man.voidlinux.org/blkid.8) command above.
222+
223+
Next, install the bootloader onto the disk using the correct `grub-install`
224+
command for your system, as stated on [Installing
225+
GRUB](chroot.md#installing-grub).
226+
242227
Ensure an initramfs is generated:
243228

244229
```

0 commit comments

Comments
 (0)