Añadir sección de despliegue con Docker CLI
This commit is contained in:
83
README.md
83
README.md
@@ -81,6 +81,89 @@ Para personalización completa del compose.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## Despliegue con Docker CLI
|
||||||
|
|
||||||
|
Si prefieres trabajar desde la línea de comandos:
|
||||||
|
|
||||||
|
### 1. Clonar el repositorio
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://git.ictiberia.com/groales/bookstack.git
|
||||||
|
cd bookstack
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Generar APP_KEY y contraseña
|
||||||
|
|
||||||
|
**APP_KEY** (requerido por BookStack):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker run --rm lscr.io/linuxserver/bookstack:latest php /app/www/artisan key:generate --show
|
||||||
|
```
|
||||||
|
|
||||||
|
Salida esperada: `base64:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx=`
|
||||||
|
|
||||||
|
**DB_PASSWORD** (contraseña de MariaDB):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
openssl rand -base64 32
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Elegir modo de despliegue
|
||||||
|
|
||||||
|
#### Opción A: Traefik (recomendado para producción)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp docker-compose.override.traefik.yml.example docker-compose.override.yml
|
||||||
|
cp .env.example .env
|
||||||
|
nano .env # Editar: pegar APP_KEY, DB_PASSWORD, configurar DOMAIN_HOST
|
||||||
|
```
|
||||||
|
|
||||||
|
⚠️ **IMPORTANTE**: `DOMAIN_HOST` es **obligatoria** en todos los casos (BookStack la usa en `APP_URL`).
|
||||||
|
|
||||||
|
#### Opción B: Nginx Proxy Manager
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cp .env.example .env
|
||||||
|
nano .env # Editar: pegar APP_KEY, DB_PASSWORD, configurar DOMAIN_HOST
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Iniciar el servicio
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker compose up -d
|
||||||
|
```
|
||||||
|
|
||||||
|
La inicialización puede tardar **30-60 segundos** (MariaDB + BookStack migrations).
|
||||||
|
|
||||||
|
### 5. Verificar el despliegue
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Ver logs en tiempo real
|
||||||
|
docker compose logs -f bookstack
|
||||||
|
|
||||||
|
# Verificar contenedores activos
|
||||||
|
docker compose ps
|
||||||
|
|
||||||
|
# Comprobar base de datos
|
||||||
|
docker compose exec bookstack-db mysql -ubookstack -p$DB_PASSWORD -e "SHOW DATABASES;"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Acceso**:
|
||||||
|
- Traefik: `https://<DOMAIN_HOST>` (ejemplo: `https://bookstack.example.com`)
|
||||||
|
- NPM: Configurar en NPM apuntando a `bookstack` puerto `80`
|
||||||
|
|
||||||
|
**Credenciales iniciales** (⚠️ **CRÍTICO: cambiar inmediatamente**):
|
||||||
|
- Email: `admin@admin.com`
|
||||||
|
- Contraseña: `password`
|
||||||
|
|
||||||
|
**Después del primer login**:
|
||||||
|
1. Ir a **Settings** → **Users**
|
||||||
|
2. Editar usuario `Admin`
|
||||||
|
3. Cambiar email y contraseña
|
||||||
|
4. O eliminar y crear usuario propio
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Modos de Despliegue
|
## Modos de Despliegue
|
||||||
|
|
||||||
### Traefik (Proxy Inverso con SSL automático)
|
### Traefik (Proxy Inverso con SSL automático)
|
||||||
|
|||||||
Reference in New Issue
Block a user