-purple.svg){kind=icon}
Warning
Estado del Proyecto: refugiOS se encuentra actualmente en su primera versión Beta. Es un proyecto en desarrollo activo y aún queda camino por delante: corrección de errores y la implementación de funciones detalladas en el roadmap.
Important
refugiOS no es una distribución Linux al uso. No se instala en tu disco duro ni reemplaza tu sistema operativo. Es un sistema portátil que arranca desde un USB y funciona de forma completamente autónoma, sin instalar nada en el ordenador anfitrión. Solo necesitas un USB de 16 GB o más.
refugiOS es un sistema operativo portátil pensado para funcionar sin conexión a Internet en situaciones de emergencia o de resiliencia personal. Se instala en un USB y arranca en cualquier PC de 64 bits (con soporte dual tanto para UEFI moderno como para BIOS tradicional) o Raspberry Pi, llevando contigo Wikipedia completa, mapas offline de todo el mundo, una IA privada local, cifrado de archivos personales y guías de supervivencia, todo funcionando sin depender de ningún servidor ni nube.
La idea es sencilla: prepáralo hoy en casa, úsalo cuando no haya Internet.
→ Consulta la Visión y Experiencia del Usuario para una descripción completa del proyecto y qué esperar al usarlo.
La forma más fácil de tener refugiOS es descargar la imagen ya preparada, grabarla en un USB y arrancar:
| Idioma | Descarga | Tamaño |
|---|---|---|
| 🇪🇸 Español | refugios-base-16G-es.img.zip | 2,9 GB comprimido (16 GB al descomprimir) |
| 🇬🇧🇺🇸 Inglés | refugios-base-16G-en.img.zip | 2,9 GB comprimido (16 GB al descomprimir) |
Última actualización de las imágenes: 25 de octubre de 2026 (versión 0.27). Si descargaste una imagen anterior a esta fecha, sustitúyela para contar con todas las correcciones, el actualizador, el traductor y la nueva biblioteca.
Descomprime el .zip antes de grabarlo: en Windows, clic derecho → Extraer todo; en Linux o macOS, unzip refugios-base-16G-es.img.zip. Obtendrás el fichero .img que se graba en el USB.
Tip
Comprueba que la descarga llegó entera. Son varios gigabytes y con una conexión inestable el fichero puede quedar incompleto, con el único síntoma de un pendrive que no arranca. Descarga SHA256SUMS.txt en la misma carpeta que el .zip y comprueba la suma antes de grabarlo:
sha256sum --ignore-missing -c SHA256SUMS.txt # Linux
shasum -a 256 --ignore-missing -c SHA256SUMS.txt # macOSEn Windows, desde PowerShell: Get-FileHash refugios-base-16G-es.img.zip -Algorithm SHA256, y compara el resultado con la línea correspondiente del fichero. Debe responder OK o coincidir carácter a carácter; si no, descarga el .zip de nuevo.
Necesitas un USB de al menos 16 GB. La partición del sistema se expandirá automáticamente al tamaño completo del USB en el primer arranque.
Note
¿Por qué no se ofrece una imagen completamente configurada de antemano? Ofrecer una imagen lista con todos los contenidos posibles (Wikipedia completa con imágenes, múltiples modelos de IA local, cartografía de todo el mundo, etc.) exigiría un archivo de descarga descomunal de más de 150 GB. Por eso se distribuye una imagen base ligera que el usuario debe configurar en un entorno controlado (no de emergencia) con una buena conexión a Internet. De este modo, en el momento de una emergencia real, el dispositivo tendrá exactamente la información y recursos específicos que necesites.
Desde Windows — Usa Rufus o balenaEtcher:
- Abre Rufus, selecciona tu USB y el archivo
.imgdescargado. - Asegúrate de que el esquema de partición es GPT y el sistema destino es UEFI.
- Pulsa Empezar y espera.
Desde Linux — Con el comando dd:
# ¡Verifica con lsblk que /dev/sdX es tu USB!
sudo dd if=refugios-base-16G-es.img of=/dev/sdX bs=4M status=progress conv=fsyncDesde macOS — Usa balenaEtcher o el comando dd:
sudo dd if=refugios-base-16G-es.img of=/dev/diskN bs=4M- Conecta el USB a cualquier PC y enciéndelo.
- Pulsa F12, F8 o Esc durante el arranque para seleccionar el USB como dispositivo de inicio.
- El sistema arrancará automáticamente en el escritorio XFCE con el usuario
refugios(sin contraseña).
Important
Toda la instalación inicial (incluyendo ejecutar este asistente) debe realizarse en un entorno controlado y con conexión a Internet ANTES de que ocurra una emergencia. Una vez finalizados todos los pasos y comprobado que el sistema funciona correctamente, tu dispositivo estará listo para operar de forma 100% offline.
En el escritorio encontrarás el icono "Completar instalación de refugiOS". Haz doble clic sobre él, conéctate a Internet cuando te lo pida, y el asistente se encargará de descargar e instalar todo el contenido según la capacidad de tu USB.
También puedes ejecutarlo desde la terminal:
curl -fsSL https://raw.githubusercontent.com/Ganso/refugiOS/main/install.sh | bashTip
La elección del dispositivo físico (pendrive, SSD, adaptador) condiciona el rendimiento y la durabilidad de tu refugiOS. Consulta la Guía de Elección del Medio antes de comprar.
La imagen pregenerada es la forma más rápida y sencilla, pero si lo necesitas, también puedes montar refugiOS de otras maneras:
💻 Montar refugiOS sobre un Live-USB de Xubuntu
Si prefieres usar una ISO de Xubuntu como base, puedes crear un USB live con persistencia y después instalar refugiOS sobre él. Este método ofrece un esquema dual alternativo (sistema inmutable + capa de persistencia). (Nota: la imagen pregenerada oficial de refugiOS ya incluye soporte nativo tanto para UEFI como para BIOS tradicional).
- Descarga Xubuntu Minimal y créalo como USB persistente con Rufus o mkusb.
- Arranca desde el USB y ejecuta el instalador:
sudo apt install curl -y curl -fsSL https://raw.githubusercontent.com/Ganso/refugiOS/main/install.sh | bash
Consulta la Guía de Instalación en Xubuntu para los pasos completos.
🍓 Montar refugiOS en Raspberry Pi
refugiOS funciona en Raspberry Pi 3B+ y superiores con Raspberry Pi OS:
- Instala Raspberry Pi OS (64-bit) con Raspberry Pi Imager.
- Arranca y ejecuta:
sudo apt install curl -y curl -fsSL https://raw.githubusercontent.com/Ganso/refugiOS/main/install.sh | bash
El instalador detecta la arquitectura ARM y adapta todo automáticamente. Consulta la Guía de Instalación en Raspberry Pi.
🛠️ Construir tu propia imagen de sistema
Si necesitas control total sobre la imagen base o quieres preparar múltiples unidades idénticas, puedes generar una imagen desde cero con Debian Trixie + XFCE:
sudo bash scripts/build_refugios.sh 16GConsulta la Guía de Construcción de Imagen de Sistema para los detalles completos.
Si quieres probar refugiOS antes de grabarlo en un USB, puedes arrancar cualquiera de las imágenes (pregenerada o construida por ti) en una máquina virtual con QEMU o VirtualBox. Esto funciona para x86 (PC y Xubuntu); la Raspberry Pi requiere hardware real.
# Con QEMU y aceleración KVM (Linux)
sudo qemu-system-x86_64 -enable-kvm -m 4G \
-bios /usr/share/ovmf/OVMF.fd \
-drive file=refugios-base-16G-es.img,format=rawConsulta la Guía de Virtualización para instrucciones completas con QEMU, VirtualBox y métodos para probar imágenes de Xubuntu.
- ⚡ Arranca en cualquier PC: Conectas el USB, enciendes y tu refugio digital funciona. No installs nada en el ordenador anfitrión.
- 🍓 Soporte nativo para Raspberry Pi: Instalación certificada en Raspberry Pi 3B+.
- 📚 Conocimiento Universal Offline: Wikipedia, enciclopedia médica, guías de emergencia y supervivencia, reparaciones, energía, diccionario y libros, organizados por categorías.
- 🤖 Inteligencia Artificial Privada: Asistente que funciona 100% en local, sin Internet.
- 🗺️ Mapas y Navegación GPS: Mapas offline de todo el mundo con Organic Maps, con los países más habituales listos desde el instalador.
- Traductor sin conexión: Más de 40 idiomas con los modelos neuronales de Firefox.
- Actualizable sin riesgo: Un icono pone al día libros, mapas, IA y aplicaciones, y no borra nada antiguo hasta verificar lo nuevo.
- Comprobación sin conexión: Un icono revisa que libros, IA, mapas y bóvedas están completos e intactos antes de necesitarlos.
- 🔒 Bóveda de Archivos Segura: Cifrado profesional LUKS para proteger documentos sensibles.
- 🌐 Adaptado a tu Idioma: El sistema se configura automáticamente en español o inglés.
Consulta el Roadmap y Aplicaciones para ver el estado actual del proyecto.
refugiOS corriendo en un Ryzen 5500, arrancado desde un pendrive USB 3.2 de gama de consumo
- Visión y Experiencia del Usuario: Qué es refugiOS y qué esperar al usarlo.
- Comparativa de Soluciones: Por qué refugiOS es diferente a otras alternativas.
- Arquitectura del Sistema: Detalles técnicos sobre la base Linux y su rendimiento.
- Elección del Medio de Instalación: Qué USB o SSD comprar según tu presupuesto.
- Guía de Virtualización: Cómo probar refugiOS en una máquina virtual (QEMU, VirtualBox).
- Instalación en Xubuntu: Método alternativo sobre Live-USB de Xubuntu.
- Instalación en Raspberry Pi: Guía específica para Raspberry Pi.
- Construcción de Imagen de Sistema: Cómo generar tu propia imagen desde cero.
- Tabla de Compatibilidad: Distribuciones y hardware certificado.
- Bóvedas de Seguridad: Cómo funciona el cifrado de archivos personales.
- Clonado de Unidades: Cómo hacer copias exactas de tu USB.
- Aplicaciones y Roadmap: Módulos disponibles y planificados.
- Actualizador integrado (Actualizar refugiOS): Búsqueda y descarga atómica de nuevas ediciones de libros, motor llamafile, modelos de IA y regiones de mapa; la versión antigua solo se sustituye cuando la nueva está descargada y verificada.
- Traductor neuronal offline (LocalTranslate): Traducción entre más de 40 idiomas de forma 100% autónoma y privada gracias a modelos integrados.
- Biblioteca organizada por categorías: Nuevos catálogos de salud y medicina, supervivencia y emergencias, conocimiento práctico y reparaciones, y educación/libros, accesibles desde la carpeta Biblioteca refugiOS.
- Auditoría de integridad (Comprobar refugiOS): Script de autodiagnóstico sin red que verifica la integridad de libros, IA, mapas y bóvedas con opción de recálculo de sumas criptográficas.
- Descargas verificadas por defecto: Descarga mediante metalinks multimirror y BitTorrent con verificación SHA-256 de cada recurso.
- Soporte de Flatpaks en Raspberry Pi: Permite instalar Organic Maps y LocalTranslate vía Flatpak en ARM64 si no hay paquete APT nativo disponible.
- Retirada de
light-locker: Previene bloqueos accidentales de sesión por inactividad en usuarios con autologin sin contraseña. - Estimaciones de espacio exactas: Ajustadas a mediciones reales de la imagen base y paquetes compartidos.
→ Consulta el CHANGELOG.md para el detalle completo de esta versión.
- Arranque universal limpio: Retirada de módulos DKMS propietarios en la imagen base que provocaban bloqueos en
Loading initial ramdisken máquinas virtuales y equipos sin GPU NVIDIA reciente. - Herramientas de instalación preinstaladas en la imagen: Se incluyen de serie
dialog,aria2,jq,rsync, etc., evitando fallos si se ejecuta el instalador sin red. - Presets de IA adaptados a la RAM: El instalador ya no recomienda modelos pesados a equipos con menos de 6 GB de RAM.
- Instalación asistida de drivers NVIDIA: Detección interactiva para aceleración CUDA opcional.
→ Consulta el CHANGELOG.md para el detalle completo de esta versión.
Versiones anteriores
- Portal web oficial y descargas en https://refugios.ganso.org.
- Corrección del enlace de autoexpansión de partición en primer arranque y validador de imágenes
tests/verify_image.sh.
- Carpeta
media/con todo el material gráfico y documentación de la suite de tests endoc/.
- Revisión crítica de scripts: confirmación de contraseña en bóvedas LUKS, reanudación de descargas parciales, corrección de Developer Mode y suite de tests automáticos.
- Robustez en diálogos latin-1 (
sanitize_for_dialog) y comprobación previa de scripts de despliegue.
→ Consulta el CHANGELOG.md para el historial completo de versiones.
La carpeta media/ reúne todo el material gráfico del proyecto:
- Logotipo en PNG, PDF vectorial y fuente de Illustrator, más el fondo de escritorio que aplica el instalador. Diseño de Felipe Monge "PlayOnRetro"; cítalo siempre que lo uses.
- Capturas de pantalla — cuarenta capturas de las aplicaciones principales funcionando, en español y en inglés, tomadas sobre el sistema real.
Gracias a Felipe Monge "PlayOnRetro" por el diseño del logo.
refugiOS es posible gracias al increíble trabajo de proyectos de código abierto como:
- Debian y Xubuntu por la base del sistema operativo.
- Raspberry Pi Foundation por el hardware y el ecosistema de software ARM.
- Kiwix y la Fundación Wikimedia por el acceso offline al conocimiento universal.
- Mozilla Ocho por el motor de inferencia Llamafile.
- HuggingFace y unsloth por las cuantizaciones optimizadas de los modelos de IA.
- Modelos de lenguaje Qwen3 (Alibaba-Qwen: 0.6B, 8B, 14B) y Gemma-4 (Google: E4B, 26B-A4B).
- Organic Maps y los colaboradores de OpenStreetMap por la cartografía offline.
- Aria2 para las descargas de alta eficiencia.
- Flatpak y Flathub por la distribución de aplicaciones modernas.
- Cryptsetup / LUKS para la seguridad y cifrado de datos personales.
(refugiOS es una iniciativa de código abierto para la resiliencia digital. Actualmente en fase Beta, buscamos colaboradores para internacionalizar la documentación y pulir la experiencia de usuario según nuestro Roadmap).