Wikipedia local con Kiwix: instala WSL, Docker y Dockge paso a paso

Instala WSL, Docker y Dockge para consultar Wikipedia local con Kiwix. Primero necesitas internet para el ZIM; después puedes consultar sin conexión.

n30j0su3·Publicado 15 Nov 2026·11 min de lectura·Tecnología y Desarrollo
En este artículo

    GUÍA COMPLEMENTARIA · WSL + DOCKER + KIWIX

    Montar una Wikipedia local que responde cuando se cae internet no empieza con un botón mágico: primero instalas el entorno, descargas un archivo ZIM y después lo abres desde tu propio equipo. Aquí tienes cada paso del video de Wikipedia 100% LOCAL en tu PC, con los comandos, las comprobaciones y las trampas que conviene evitar.

    En 30 segundos: Windows ejecuta Ubuntu mediante WSL; Docker pone en marcha Kiwix; Dockge te ayuda a gestionar el contenedor; un ZIM contiene la biblioteca. La instalación y la descarga inicial sí necesitan internet. Cuando el ZIM ya está en tu disco, Kiwix puede servirlo en localhost:8085 sin conexión.

    Qué muestra realmente el video

    El recorrido original pasa por WSL, Ubuntu, Docker, un gestor de contenedores y Kiwix. En el camino aparecen errores de instalación y un cambio de Portainer a Dockge. Al final se ve el catálogo local y la portada de WikiDex, una enciclopedia temática; esa toma no demuestra por sí sola que ya se haya abierto un artículo de Wikipedia sin internet. Por eso esta guía distingue la instalación de la prueba offline, que harás tú en el último paso.

    La miniatura original deja ver la portada de WikiDex en localhost:8085. No muestra un artículo de Wikipedia probado offline. El enlace al video necesita internet; no forma parte de la biblioteca local.

    Si vienes de nuestra guía anterior de Docker y contenedores, aquí el objetivo cambia: no montar varias aplicaciones, sino conservar una biblioteca consultable en tu PC.

    Cuatro piezas, una sola ruta

    ← Desliza la tabla para leer todas las columnas →

    PiezaEn palabras normalesQué guarda
    WSL + UbuntuUn entorno Linux dentro de WindowsLos archivos y comandos de esta instalación
    Docker EngineArranca Kiwix en un contenedor aisladoLa imagen descargada y el estado del contenedor
    DockgePanel opcional para crear y administrar la «stack»El archivo Compose y sus ajustes
    ZIM + KiwixEl ZIM es el contenido; Kiwix lo sirve en tu navegadorLos datos están en tu carpeta ~/zim
    La regla de oro: Docker no «descarga Wikipedia» por arte de magia. Si ~/zim está vacía, Kiwix no tiene biblioteca que mostrar.
    Diagrama de dependencias Windows, WSL Ubuntu, Docker, Dockge, Kiwix y archivo ZIM

    Dockge solo gestiona Docker; Kiwix lee el archivo ZIM montado desde Ubuntu. No confundas un panel encendido con contenido ya descargado.

    Antes de instalar: tres comprobaciones que evitan una tarde perdida

    1. Usa Windows 11 o Windows 10 compatible con WSL y abre PowerShell como administrador. Microsoft documenta Windows 10 versión 2004 (build 19041) o superior para wsl --install.
    2. Reserva espacio en disco según el ZIM que elijas; un paquete pequeño y una edición extensa no ocupan lo mismo. Comprueba el tamaño concreto en el catálogo oficial de Kiwix antes de descargar.
    3. Decide qué Docker usarás. Esta ruta instala Docker Engine dentro de Ubuntu WSL. Si ya usas Docker Desktop con integración WSL, no instales un segundo motor sin saber cuál atiende tus comandos.

    Durante la preparación necesitas conexión para Ubuntu, los paquetes de Docker, las imágenes de Dockge/Kiwix y el ZIM. La desconexión se prueba después. La guía de Microsoft para WSL y el procedimiento oficial de Docker para Ubuntu son las referencias si tu versión muestra una pantalla diferente.

    1. Instala Ubuntu en Windows con WSL

    En PowerShell (administrador), no en la terminal Ubuntu, ejecuta:

    wsl --install

    Reinicia Windows si te lo pide y abre Ubuntu para crear tu usuario Linux. El comando ya instala Ubuntu por defecto: no hace falta repetirlo. Si prefieres una edición concreta, consulta las distribuciones y elige una antes de instalar:

    wsl --list --online
    wsl --install -d Ubuntu-24.04

    Comprueba desde PowerShell que Ubuntu usa WSL 2:

    wsl --list --verbose
    ¿systemctl dice que no hay systemd? No es un fallo de Kiwix. En Ubuntu abre sudo nano /etc/wsl.conf, añade [boot] y en la siguiente línea systemd=true; cierra Ubuntu y ejecuta wsl --shutdown desde PowerShell. Reabre Ubuntu y verifica systemctl status. Sigue la documentación de systemd en WSL antes de editar una configuración existente.

    2. Instala Docker Engine dentro de Ubuntu

    Los siguientes bloques van en la terminal Ubuntu. Añade la llave oficial y el repositorio APT de Docker:

    sudo apt update
    sudo apt install ca-certificates curl
    sudo install -m 0755 -d /etc/apt/keyrings
    sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
    sudo chmod a+r /etc/apt/keyrings/docker.asc
    
    sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
    Types: deb
    URIs: https://download.docker.com/linux/ubuntu
    Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
    Components: stable
    Architectures: $(dpkg --print-architecture)
    Signed-By: /etc/apt/keyrings/docker.asc
    EOF
    sudo apt update

    El bloque entre <<EOF y EOF se pega completo en una sola operación; los demás comandos se pueden ejecutar línea por línea. Después instala los paquetes oficiales:

    sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
    sudo systemctl status docker --no-pager
    sudo docker version
    sudo docker compose version

    Si Docker no está activo y systemd ya funciona, usa sudo systemctl start docker y vuelve a verificar. Durante esta guía utilizamos sudo docker: agregar un usuario al grupo docker concede privilegios equivalentes a administrar el motor, y no hace falta para seguir el tutorial. Si quieres ampliar tu base, tenemos una guía de otras aplicaciones con Docker.

    Portátil en un escritorio oscuro; ilustración de la idea de llevar la biblioteca al propio equipo
    El portátil representa la consulta local: no es una captura del programa ni una medición de velocidad.

    3. Dockge: un panel para el contenedor, no para toda internet

    Dockge es opcional: podrías levantar el Compose desde Ubuntu sin panel. En el video se pasa de Portainer a Dockge; no necesitas los dos. Dockge controla Docker mediante /var/run/docker.sock, una capacidad poderosa: limita su acceso a tu equipo y no publiques el puerto 5001 en internet. Hay un aviso de seguridad de severidad alta para Dockge sobre rutas fuera de la carpeta de stacks accesibles a usuarios autenticados; antes de usarlo con servicios sensibles, revisa la versión y las mitigaciones vigentes. No desactives la autenticación.

    sudo mkdir -p /opt/stacks /opt/dockge
    cd /opt/dockge
    sudo curl -fL https://raw.githubusercontent.com/louislam/dockge/master/compose.yaml -o compose.yaml
    sudo nano compose.yaml

    Antes de iniciar, busca en el Compose oficial - 5001:5001 y cámbialo por - "127.0.0.1:5001:5001". Así el panel escucha solo en la computadora; deja intacto el montaje /opt/stacks:/opt/stacks. Guarda con Ctrl+O, Enter, Ctrl+X; valida y arranca:

    sudo docker compose config
    sudo docker compose up -d
    sudo docker compose ps

    Abre http://localhost:5001 en Windows y crea la cuenta de administración inmediatamente, antes de abrir el panel a otras personas: la configuración inicial sin usuario puede reclamarse desde el navegador. Si no abre, primero comprueba en Ubuntu curl -I http://127.0.0.1:5001; el paso de Windows a WSL puede depender de su configuración de red. La receta oficial de Dockge explica dónde se guardan las stacks.

    4. El archivo ZIM: elige qué biblioteca quieres conservar

    Un ZIM es el archivo que contiene el contenido consultable por Kiwix. Abre el catálogo de la biblioteca Kiwix, filtra por idioma/tema y revisa nombre, fecha y tamaño de la edición concreta. «Lo mejor de Wikipedia» y una edición más extensa son opciones distintas; el video comenta una selección alrededor de 200 MB, pero ese dato no describe el tamaño de todas las ediciones ni garantiza el mismo archivo hoy. También puedes elegir una enciclopedia temática como WikiDex.

    En Ubuntu crea la carpeta donde guardarás lo descargado y ábrela en el Explorador de Windows para copiar allí el .zim que elegiste:

    mkdir -p "$HOME/zim"
    cd "$HOME/zim"
    explorer.exe .
    realpath "$HOME/zim"
    find "$HOME/zim" -maxdepth 1 -type f -name '*.zim' -print

    Espera a que la copia finalice. El último comando debe listar al menos un archivo .zim completo directamente en esa carpeta, no en una subcarpeta; no cambies su extensión a mano. Si el catálogo publica un checksum para tu archivo, compáralo con sha256sum "ruta/al/archivo.zim"; un archivo parcialmente descargado no se arregla cambiando el nombre. Comprueba también el espacio físico libre en Windows, además del mostrado por Ubuntu: el disco virtual de WSL crece sobre el disco anfitrión.

    Diagrama de cuatro pasos: instalar y descargar requieren internet; servir y consultar Kiwix pueden funcionar sin internet cuando el ZIM ya está en disco
    «100 % local» describe la consulta después de adquirir el software y el archivo. No equivale a una instalación inicial sin red.

    5. Levanta Kiwix con tu ZIM local

    En Dockge crea una nueva stack llamada kiwix. Pega este Compose. Sustituye /home/TU_USUARIO/zim por la ruta exacta que devolvió realpath "$HOME/zim" en tu Ubuntu; no pegues la ruta de otra persona.

    services:
      kiwix-serve:
        image: ghcr.io/kiwix/kiwix-serve:3.8.2
        ports:
          - "127.0.0.1:8085:8080"
        volumes:
          - type: bind
            source: /home/TU_USUARIO/zim
            target: /data
            read_only: true
            bind:
              create_host_path: false
        command: ["*.zim"]
        restart: unless-stopped

    La ruta source es tu carpeta Ubuntu; /data es la misma carpeta vista desde el contenedor. read_only: true evita que Kiwix altere tus ZIM. create_host_path: false hace que una ruta mal escrita falle en vez de crear silenciosamente una carpeta vacía. "*.zim" llega como argumento literal a la imagen; su script de arranque expande el patrón solo en el primer nivel de /data. Si no hay archivos coincidentes, Kiwix no tendrá contenido y puede reiniciarse en bucle. El puerto 8085 es el del navegador en tu computadora; dentro del contenedor Kiwix escucha en 8080. Esta versión fija 3.8.2 evita que una etiqueta latest cambie la receta sin avisar. Los PUID=1000 y PGID=1000 del archivo adjunto no controlan los permisos de esta imagen.

    “or, if you want to load all ZIM files within a directory, then use globbing:”

    Documentación oficial de Kiwix Serve para Docker; por eso el ejemplo conserva "*.zim" entre comillas.

    Pulsa Deploy en Dockge o, si prefieres terminal, guarda el Compose en una carpeta propia y ejecuta sudo docker compose config seguido de sudo docker compose up -d. Usa un método de gestión para esa stack; no crees dos instancias con el mismo puerto. Si luego agregas otro ZIM a la carpeta, reinicia Kiwix desde Dockge para que relea la colección.

    Ilustración conceptual de una unidad rectangular oscura sobre libros como metáfora de una biblioteca guardada localmente
    Lo que sobrevive al reinicio es el archivo ZIM en tu carpeta: el contenedor solo lo sirve. Imagen conceptual, no fotografía de Kiwix.

    6. Primero pruébalo encendido; después, sin internet

    1. Con internet, visita http://localhost:8085 desde Windows. Comprueba que aparece el catálogo y que puedes abrir un artículo del ZIM que realmente descargaste.
    2. En Ubuntu, verifica el estado con sudo docker ps y, si falla, consulta sudo docker logs --tail 80 kiwix-kiwix-serve-1 solo si ese es el nombre real; míralo primero en sudo docker ps -a o usa el botón Logs de Dockge.
    3. Desconecta la conexión de internet del PC —sin apagar Windows ni WSL—, recarga http://localhost:8085 y abre un artículo distinto del mismo ZIM. El video embebido y los enlaces externos no cargan sin red: no son parte de la prueba.
    Éxito de verdad: un artículo de tu ZIM se abre sin conexión. Ver solamente la portada, el panel de Dockge o un contenedor en estado «running» no demuestra la consulta offline.

    Para entender cómo distinguir un despliegue que parece sano de uno que realmente sirve contenido, lee nuestro enfoque de canary y comprobación real.

    Si algo falla: diagnóstico sin borrar tu biblioteca

    ← Desliza la tabla para leer todas las columnas →

    SíntomaCompruebaQué hacer
    systemctl no responde¿Ubuntu arrancó con systemd?Revisa /etc/wsl.conf y reinicia WSL según Microsoft; no reinstales Docker a ciegas.
    Dockge abre, Kiwix vacío o no arrancarealpath "$HOME/zim", find ... -name '*.zim' y LogsCorrige el bind mount y espera a que termine la copia del ZIM.
    El ZIM existe, pero Kiwix dice «permission denied»id -u, id -g y namei -l "$(realpath "$HOME/zim")"La imagen usa un usuario interno distinto del tuyo. Si el ZIM pertenece a tu cuenta, puedes indicar user: "1000:1000" solo si esos son tus UID/GID reales; verifica permisos de lectura y acceso a los directorios. No uses chmod 777.
    Puerto 8085 ocupadosudo docker ps --format 'table {{.Names}}\t{{.Ports}}'Usa otro puerto host, por ejemplo 127.0.0.1:8086:8080, y visita ese nuevo puerto.
    Abre en Ubuntu, no en Windowscurl -I http://127.0.0.1:8085 en UbuntuRevisa la integración/red de WSL antes de publicar Kiwix en todas las interfaces.
    Windows sin red, artículo no abre¿El ZIM está íntegro y ese artículo pertenece a ese archivo?Prueba el mismo artículo con internet. Si tampoco abre, inspecciona archivo y logs antes de repetir la descarga.

    No borres volúmenes ni la carpeta ~/zim para «reiniciar». Tus archivos son precisamente lo que querías conservar. Un docker compose down detiene la stack; no elimina por sí solo el ZIM que guardaste fuera del contenedor.

    Preguntas frecuentes

    ¿Puedo instalar Kiwix sin Dockge?

    Sí. Dockge es el panel opcional; Docker Compose puede arrancar el mismo archivo desde Ubuntu. No administres duplicada la misma stack.

    ¿Necesito internet cada vez que abra la biblioteca?

    No para el contenido ya descargado y servido localmente, siempre que WSL, Docker y Kiwix estén funcionando. Sí para obtener o actualizar imágenes, paquetes y nuevos ZIM.

    ¿Ese ZIM contiene toda Wikipedia?

    Depende de la edición concreta. «Lo mejor de Wikipedia», una versión completa y WikiDex no son el mismo archivo. Revisa nombre, idioma, fecha y tamaño en el catálogo antes de descargar.

    ¿El video ya prueba un artículo de Wikipedia abierto sin red?

    No. Lo que aparece al cierre es el catálogo local y la portada de WikiDex. Usa la prueba del paso 6 con un artículo de tu archivo y la conexión apagada.


    Continúa explorando Tecnología y Desarrollo con piezas relacionadas y evidencia adicional.

    Ver relacionados
    Escrito por

    n30j0su3

    Escritor en Freaking JSON. Apasionado por la tecnología, gaming y cultura geek.

    Deja un comentario