From 7b22ccc83d092f5190ff967891c59a3c50c67156 Mon Sep 17 00:00:00 2001
From: groales <gustavo.roales@ictiberia.com>
Date: Thu, 4 Dec 2025 16:52:46 +0100
Subject: [PATCH] =?UTF-8?q?Documentar=20APP=5FKEY=20en=20wiki=20(generaci?=
 =?UTF-8?q?=C3=B3n=20y=20variables=20de=20entorno)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Home.md    | 9 +++++++--
 NPM.md     | 1 +
 Traefik.md | 4 +++-
 3 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/Home.md b/Home.md
index f399ca3..ea019e4 100644
--- a/Home.md
+++ b/Home.md
@@ -55,11 +55,14 @@ BookStack es una **plataforma de documentación y wiki** de código abierto que
 - Red `proxy` creada
 - MariaDB 12 (incluido en el compose)
 
-### Generar Contraseña
+### Generar Claves y Contraseñas
 
-**ANTES de desplegar**, genera 1 contraseña segura:
+**ANTES de desplegar**, genera las claves necesarias:
 
 ```bash
+# APP_KEY (BookStack)
+docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey
+
 # DB_PASSWORD (MariaDB)
 openssl rand -base64 32
 ```
@@ -77,7 +80,9 @@ openssl rand -base64 32
 
 2. **Añade variables de entorno**:
    ```env
+   APP_KEY=base64:tu_clave_generada
    DB_PASSWORD=password_generado
+   DOMAIN_HOST=bookstack.tudominio.com
    ```
 
 3. **Deploy** y espera 1-2 minutos (BookStack inicializa la BD)
diff --git a/NPM.md b/NPM.md
index e7e8744..5c3a9e7 100644
--- a/NPM.md
+++ b/NPM.md
@@ -18,6 +18,7 @@ En Portainer, crea el stack **sin archivo override** (solo `docker-compose.yml`)
 
 **Variables de entorno**:
 ```env
+APP_KEY=base64:tu_clave_generada
 DB_PASSWORD=password_generado
 DOMAIN_HOST=bookstack.tudominio.com
 ```
diff --git a/Traefik.md b/Traefik.md
index 7e717f6..d2e29d5 100644
--- a/Traefik.md
+++ b/Traefik.md
@@ -19,7 +19,8 @@ En Portainer, al crear el stack con **Git Repository**, configura:
 
 **Environment variables**:
 ```env
-# Contraseña (generada previamente)
+# Claves requeridas
+APP_KEY=base64:tu_clave_generada
 DB_PASSWORD=tu_password_generado
 
 # Base de datos (valores por defecto)
@@ -106,6 +107,7 @@ services:
       PGID: 1000
       TZ: Europe/Madrid
       APP_URL: https://${DOMAIN_HOST:-bookstack.example.com}
+      APP_KEY: ${APP_KEY}
       DB_HOST: bookstack-db
       DB_PORT: 3306
       DB_DATABASE: ${DB_NAME:-bookstack}