Docker: BookStack - para qué sirve y cómo instalarlo

octubre 21, 2026

Publicado por Curso Docker

Imagen Docker del curso, nº 5. BookStack es una wiki sencilla organizada en estantes, libros, capítulos y páginas. Ideal para documentar procesos, apuntes o la base de conocimiento de un equipo.

¿Para qué sirve?

Crear una wiki o documentación interna fácil de mantener.

Instalación con docker run

Este es el comando del README oficial (cambia las rutas /path/to/... por carpetas de tu equipo):

docker run -d \
  --name=bookstack \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e APP_URL= \
  -e APP_KEY= \
  -e DB_HOST= \
  -e DB_PORT=3306 \
  -e DB_USERNAME= \
  -e DB_PASSWORD= \
  -e DB_DATABASE= \
  -e QUEUE_CONNECTION= `#optional` \
  -p 6875:80 \
  -v /path/to/bookstack/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/bookstack:latest

Instalación con Docker Compose

Ejemplo de docker-compose.yml del README oficial. Guárdalo como docker-compose.yml y ejecuta docker compose up -d:

services:
  bookstack:
    image: lscr.io/linuxserver/bookstack:latest
    container_name: bookstack
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - APP_URL=
      - APP_KEY=
      - DB_HOST=
      - DB_PORT=3306
      - DB_USERNAME=
      - DB_PASSWORD=
      - DB_DATABASE=
      - QUEUE_CONNECTION= #optional
    volumes:
      - /path/to/bookstack/config:/config
    ports:
      - 6875:80
    restart: unless-stopped

Consejos

Sustituye siempre las rutas de ejemplo por carpetas reales de tu equipo.
Comprueba que el contenedor está activo con docker ps y revisa los logs con docker logs NOMBRE.
Cambia las contraseñas por defecto antes de exponer el servicio fuera de tu red.

Antes de empezar con BookStack

Necesitas un equipo con Docker instalado y funcionando. Comprueba la versión con docker --version y la de Compose con docker compose version. Si tu usuario no está en el grupo docker, tendrás que anteponer sudo a los comandos. Mira también que el puerto 6875 estén libres con ss -tulpn | grep 6875: si otro servicio usa alguno, el contenedor no arrancará y tendrás que elegir otro puerto en la parte izquierda de la asignación.

Cómo comprobar que BookStack funciona

Después de arrancar el contenedor, ejecuta docker ps y busca bookstack en la lista con estado Up. Si aparece reiniciándose o desaparece al poco rato, lee el motivo con docker logs -f bookstack; casi siempre es una ruta mal escrita o un permiso. Cuando esté estable, si la aplicación tiene interfaz web, ábrela en el navegador con la dirección y el puerto que indica el README oficial. Dale un minuto en el primer arranque, porque algunas aplicaciones preparan su base de datos antes de aceptar conexiones.

Dónde se guardan los datos

En el ejemplo se montan estas rutas: /path/to/bookstack/config:/config. La parte de la izquierda es la carpeta de tu equipo y la de la derecha es la ruta dentro del contenedor. Todo lo que quieras conservar debe estar en una carpeta montada, porque lo que queda dentro del contenedor se pierde si lo eliminas. Crea las carpetas antes de arrancar, con el usuario que vaya a usarlas, para evitar errores de permisos.

Cómo actualizar BookStack

Para actualizar con Compose, ve a la carpeta del docker-compose.yml y ejecuta docker compose pull seguido de docker compose up -d. Docker descarga la imagen nueva y recrea el contenedor sin tocar tus carpetas montadas. Después puedes limpiar imágenes viejas con docker image prune.

Copia de seguridad de BookStack

Antes de actualizar o cambiar nada, copia las carpetas que montaste. Lo más seguro es parar el contenedor con docker stop bookstack, comprimir la carpeta con tar czf copia-bookstack.tar.gz /ruta/a/tu/carpeta y volver a arrancarlo con docker start bookstack. Guarda la copia en otro disco o en otro equipo, y prueba a restaurarla de vez en cuando: una copia que nunca has probado no es una garantía.

Fuentes: README en GitHub · Docker Hub

Buscar este blog

Curso Docker