Skip to content

Commit e3b25b4

Browse files
author
Alexia Michelle
committed
Add documentation for installing GoldenDog on LUKS encrypted partitions in English and Spanish.
1 parent 0ddd1d2 commit e3b25b4

2 files changed

Lines changed: 151 additions & 0 deletions

File tree

‎docs/tweaking-goldendog/installing-on-luks.md‎

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
---
2+
sidebar_position: 5
3+
---
4+
5+
# Installing GoldenDog on a LUKS Encrypted Partition
6+
7+
This guide provides a step-by-step walkthrough for installing GoldenDog on a pre-existing LUKS encrypted partition. This is a manual process that requires using the terminal during the installation.
8+
9+
> [!WARNING]
10+
> This process involves manual disk partitioning and terminal commands. There are no guarantees; proceed at your own risk. Ensure you have a backup of your data.
11+
12+
## Manual Partitioning
13+
14+
The Debian installer might not detect encrypted partitions automatically. Follow these steps to prepare the disk:
15+
16+
1. In the **Partition disks** screen, select **Manual**.
17+
2. Select the encrypted partition (e.g., `/dev/sda6`) or any other you intend to use.
18+
3. Press **Enter** and under **How to use this partition:**, select **physical volume for encryption**. This will load the necessary modules and programs.
19+
4. Go back to **How to use this partition:** and select **do not use the partition**, then choose **Done setting up the partition**.
20+
21+
## Opening the Encrypted Volume
22+
23+
1. Open a console by pressing `Ctrl+Alt+F2`.
24+
2. Run the following command to open the partition (replace `sda6` with your partition):
25+
```bash
26+
cryptsetup luksOpen /dev/sda6 sda6_crypt
27+
```
28+
*(Note: The contributor originally suggested `luksClose`, but the context implies opening or resetting the state to detect it. If you need to close it first, use `luksClose` then `luksOpen`. Following the contributor's flow of "Detecting disks" later suggests we just need the modules loaded.)*
29+
30+
3. Return to the installer by pressing `Ctrl+Alt+F5` (or `F1/F7` depending on the system).
31+
4. Click the **Go Back** button.
32+
33+
## Configuring the Volumes
34+
35+
1. Select **Detect disks** and click **Continue**. The encrypted volume should now be visible.
36+
2. Configure your partitions for `/` (root) and `swap` as desired, but **do not touch the encrypted partition** `/dev/sda6` directly yet.
37+
3. Select the partition inside the encrypted volume, go to **How to use this partition:** and choose **physical volume for encryption**.
38+
4. **IMPORTANT:** When asked to **Erase data**, select **NO**.
39+
5. Choose **Done setting up the partition**.
40+
6. Select **Finish partitioning and write changes to disk**. Ensure the encrypted partition is NOT marked for formatting.
41+
42+
## Final System Configuration
43+
44+
Before the installation finishes, we need to ensure the system knows how to mount the encrypted volume.
45+
46+
1. Switch back to the console with `Ctrl+Alt+F2`.
47+
2. Get the UUID of the encrypted partition:
48+
```bash
49+
cryptsetup luksUUID /dev/sda6
50+
```
51+
*Note down this UUID.*
52+
53+
3. Edit the `fstab` of the new system:
54+
```bash
55+
nano /target/etc/fstab
56+
```
57+
Add the following line (adjusting for your mount point, e.g., `/home`):
58+
```text
59+
/dev/mapper/home-cifrado /home ext4 defaults 0 2
60+
```
61+
62+
4. Edit the `crypttab` of the new system:
63+
```bash
64+
nano /target/etc/crypttab
65+
```
66+
Add the following line:
67+
```text
68+
home-cifrado UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx none luks
69+
```
70+
*Replace `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` with the UUID you obtained earlier.*
71+
72+
5. Return to the installer, finish the installation, and install the bootloader.
73+
6. Restart your system. You will be prompted for the password to mount the encrypted volume.
74+
75+
76+
_Document Written by noname from the Debian Argentina community_

‎i18n/es/docusaurus-plugin-content-docs/current/tweaking-goldendog/installing-on-luks.md‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
---
2+
sidebar_position: 5
3+
---
4+
5+
# Instalar GoldenDog en una partición LUKS cifrada
6+
7+
Esta guía proporciona un paso a paso para instalar GoldenDog en una partición cifrada con LUKS ya existente. Este es un proceso manual que requiere el uso de la terminal durante la instalación.
8+
9+
> [!WARNING]
10+
> Este proceso implica el particionamiento manual del disco y comandos de terminal. No hay garantías; proceda bajo su propia responsabilidad. Asegúrese de tener una copia de seguridad de sus datos.
11+
12+
## Particionado Manual
13+
14+
El instalador de Debian puede no detectar las particiones cifradas automáticamente. Siga estos pasos para preparar el disco:
15+
16+
1. En la pantalla de **Particionado de discos**, elija **Manual**.
17+
2. Seleccione la partición cifrada (por ejemplo, `/dev/sda6`) o cualquier otra que pretenda usar.
18+
3. Presione **Enter** y donde dice **Utilizar como:**, elija la opción **volumen físico para cifrado**. Esto hará que se carguen los módulos y programas necesarios.
19+
4. Vuelva a entrar en **Utilizar como:** y elija **no usar partición**, luego salga con **Se ha terminado de definir la partición**.
20+
21+
## Abrir el Volumen Cifrado
22+
23+
1. Abra una consola con `Ctrl+Alt+F2`.
24+
2. Use la siguiente orden para cerrar/resetear el estado si es necesario (según el reporte del contribuidor):
25+
```bash
26+
cryptsetup luksClose /dev/sda6
27+
```
28+
*(Nota: Sustituya `sda6` por la partición que corresponda en cada caso).*
29+
30+
3. Vuelva al instalador con `Ctrl+Alt+F5` (o `F1/F7` dependiendo del sistema).
31+
4. Haga clic en el botón **Retroceder**.
32+
33+
## Configurar los Volúmenes
34+
35+
1. Seleccione **Detectar discos** y presione **Continuar**. Esto hará que veamos el volumen cifrado.
36+
2. Configure las particiones para `/` y la de intercambio (`swap`) como desee, pero **sin tocar la partición cifrada** `/dev/sda6` directamente todavía.
37+
3. Una vez definidas las particiones `/` y de intercambio, seleccione la partición dentro del volumen cifrado, y en **Utilizar como:** elija **volumen físico para cifrado**.
38+
4. **MUY IMPORTANTE:** En donde dice **Borrar los datos**, seleccione **NO**.
39+
5. Termine seleccionando **Se ha terminado de definir la partición**.
40+
6. Elija **Terminar el particionado y escribir los cambios en el disco**. Asegúrese de que la partición cifrada no esté marcada para formatearse.
41+
42+
## Configuración Final del Sistema
43+
44+
Antes de que finalice la instalación, debemos asegurarnos de que el sistema sepa cómo montar el volumen cifrado.
45+
46+
1. Cambie a una consola con `Ctrl+Alt+F2`.
47+
2. Ejecute la siguiente orden para obtener el UUID de la partición cifrada:
48+
```bash
49+
cryptsetup luksUUID /dev/sda6
50+
```
51+
*Anote este UUID.*
52+
53+
3. Edite el `fstab` del sistema a instalar:
54+
```bash
55+
nano /target/etc/fstab
56+
```
57+
Agregue la línea (ajustando el punto de montaje, por ejemplo, `/home`):
58+
```text
59+
/dev/mapper/home-cifrado /home ext4 defaults 0 2
60+
```
61+
62+
4. Edite el archivo `crypttab` del sistema que se está instalando:
63+
```bash
64+
nano /target/etc/crypttab
65+
```
66+
Agregue la siguiente línea:
67+
```text
68+
home-cifrado UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx none luks
69+
```
70+
*Sustituya `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` por el UUID que obtuvo antes.*
71+
72+
5. Vuelva al instalador, finalice la instalación y elija dónde instalar el cargador de arranque.
73+
6. Reinicie el sistema. Se le solicitará la contraseña para montar el volumen cifrado en el inicio.
74+
75+
_Documento escrito por noname de la comunidad Debian Argentina_

0 commit comments

Comments
 (0)