Documentar APP_KEY en wiki (generación y variables de entorno)

2025-12-04 16:52:46 +01:00
parent 80550b10c9
commit 7b22ccc83d
3 changed files with 11 additions and 3 deletions

@@ -55,11 +55,14 @@ BookStack es una **plataforma de documentación y wiki** de código abierto que
- Red `proxy` creada - Red `proxy` creada
- MariaDB 12 (incluido en el compose) - 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 ```bash
# APP_KEY (BookStack)
docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey
# DB_PASSWORD (MariaDB) # DB_PASSWORD (MariaDB)
openssl rand -base64 32 openssl rand -base64 32
``` ```
@@ -77,7 +80,9 @@ openssl rand -base64 32
2. **Añade variables de entorno**: 2. **Añade variables de entorno**:
```env ```env
APP_KEY=base64:tu_clave_generada
DB_PASSWORD=password_generado DB_PASSWORD=password_generado
DOMAIN_HOST=bookstack.tudominio.com
``` ```
3. **Deploy** y espera 1-2 minutos (BookStack inicializa la BD) 3. **Deploy** y espera 1-2 minutos (BookStack inicializa la BD)

1
NPM.md

@@ -18,6 +18,7 @@ En Portainer, crea el stack **sin archivo override** (solo `docker-compose.yml`)
**Variables de entorno**: **Variables de entorno**:
```env ```env
APP_KEY=base64:tu_clave_generada
DB_PASSWORD=password_generado DB_PASSWORD=password_generado
DOMAIN_HOST=bookstack.tudominio.com DOMAIN_HOST=bookstack.tudominio.com
``` ```

@@ -19,7 +19,8 @@ En Portainer, al crear el stack con **Git Repository**, configura:
**Environment variables**: **Environment variables**:
```env ```env
# Contraseña (generada previamente) # Claves requeridas
APP_KEY=base64:tu_clave_generada
DB_PASSWORD=tu_password_generado DB_PASSWORD=tu_password_generado
# Base de datos (valores por defecto) # Base de datos (valores por defecto)
@@ -106,6 +107,7 @@ services:
PGID: 1000 PGID: 1000
TZ: Europe/Madrid TZ: Europe/Madrid
APP_URL: https://${DOMAIN_HOST:-bookstack.example.com} APP_URL: https://${DOMAIN_HOST:-bookstack.example.com}
APP_KEY: ${APP_KEY}
DB_HOST: bookstack-db DB_HOST: bookstack-db
DB_PORT: 3306 DB_PORT: 3306
DB_DATABASE: ${DB_NAME:-bookstack} DB_DATABASE: ${DB_NAME:-bookstack}