refugiOS - Tu Refugio Digital y Biblioteca de Supervivencia

🇬🇧🇺🇸 Read this in English

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.

¿Qué es refugiOS?

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 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.

---

Inicio Rápido: Descarga la Imagen Pregenerada

La forma más fácil de tener refugiOS es descargar la imagen ya preparada, grabarla en un USB y arrancar:

1. Descarga la imagen

Idioma	Enlace	Tamaño aprox.
🇪🇸 Español	refugios-base-16G-es.img	~16 GB
🇬🇧🇺🇸 Inglés	refugios-base-16G-en.img	~16 GB

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.

2. Graba la imagen en tu USB

Desde Windows — Usa Rufus o balenaEtcher:

1. Abre Rufus, selecciona tu USB y el archivo .img descargado.
2. Asegúrate de que el esquema de partición es GPT y el sistema destino es UEFI.
3. 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=fsync

Desde macOS — Usa balenaEtcher o el comando dd:

sudo dd if=refugios-base-16G-es.img of=/dev/diskN bs=4M

3. Arranca desde el USB

1. Conecta el USB a cualquier PC y enciéndelo.
2. Pulsa F12, F8 o Esc durante el arranque para seleccionar el USB como dispositivo de inicio.
3. El sistema arrancará automáticamente en el escritorio XFCE con el usuario refugios (sin contraseña).

4. Completa la instalación

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 | bash

Tip

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.

---

Métodos Alternativos

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 compatibilidad con hardware antiguo (BIOS/MBR) y un esquema dual (sistema inmutable + capa de persistencia).

1. Descarga Xubuntu Minimal y créalo como USB persistente con Rufus o mkusb.
2. 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:

1. Instala Raspberry Pi OS (64-bit) con Raspberry Pi Imager.
2. 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 16G

Consulta la Guía de Construcción de Imagen de Sistema para los detalles completos.

---

Probar en una Máquina Virtual

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=raw

Consulta la Guía de Virtualización para instrucciones completas con QEMU, VirtualBox y métodos para probar imágenes de Xubuntu.

---

Características Principales

• ⚡ 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: Copias completas de la Wikipedia, WikiMed, enciclopedias de supervivencia y guías de oficios.
• 🤖 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.
• 🔒 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.

Vídeo de Demostración

refugiOS corriendo en un Ryzen 5500, arrancado desde un pendrive USB 3.2 de gama de consumo

---

Documentación Detallada

Fundamentos

• 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.

Instalación y Configuración

• 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.

Uso y Mantenimiento

• 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.

---

Agradecimientos y Fuentes

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).