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.
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 →
| Pieza | En palabras normales | Qué guarda |
|---|---|---|
| WSL + Ubuntu | Un entorno Linux dentro de Windows | Los archivos y comandos de esta instalación |
| Docker Engine | Arranca Kiwix en un contenedor aislado | La imagen descargada y el estado del contenedor |
| Dockge | Panel opcional para crear y administrar la «stack» | El archivo Compose y sus ajustes |
| ZIM + Kiwix | El ZIM es el contenido; Kiwix lo sirve en tu navegador | Los datos están en tu carpeta ~/zim |
~/zim está vacía, Kiwix no tiene biblioteca que mostrar.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
- 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. - 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.
- 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 --installReinicia 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.04Comprueba desde PowerShell que Ubuntu usa WSL 2:
wsl --list --verbosesystemctl 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 updateEl 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 versionSi 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.
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.yamlAntes 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 psAbre 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' -printEspera 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.
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-stoppedLa 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.
6. Primero pruébalo encendido; después, sin internet
- 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.
- En Ubuntu, verifica el estado con
sudo docker psy, si falla, consultasudo docker logs --tail 80 kiwix-kiwix-serve-1solo si ese es el nombre real; míralo primero ensudo docker ps -ao usa el botón Logs de Dockge. - Desconecta la conexión de internet del PC —sin apagar Windows ni WSL—, recarga
http://localhost:8085y 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.
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íntoma | Comprueba | Qué 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 arranca | realpath "$HOME/zim", find ... -name '*.zim' y Logs | Corrige 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 ocupado | sudo 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 Windows | curl -I http://127.0.0.1:8085 en Ubuntu | Revisa 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



