Guía de Instalación Linux - Atlas Interactivo

Distribuciones Compatibles

Atlas Interactivo funciona en cualquier distribución Linux moderna de 64-bit gracias a AppImage.

Ubuntu

20.04 LTS o superior

Debian

11 (Bullseye) o superior

Fedora

34 o superior

Arch Linux

Cualquier versión reciente

          # Verifica tu distribución y versión

          cat /etc/os-release

          # Verifica si es 64-bit

          uname -m

          # Debe mostrar: x86_64 o aarch64

Requisitos del Sistema

Arquitectura

x86_64 (64-bit)

Memoria RAM

Mínimo 2 GB

Espacio en Disco

15 GB libres

Entorno Gráfico

GNOME, KDE, XFCE, etc.

Nota sobre AppImage: No requiere dependencias especiales ni instalación en el sistema. Todo está contenido en un solo archivo ejecutable.

Métodos de Instalación

Elige el método que prefieras:

Qt GUI (Recomendado)

Terminal

Método Qt GUI (Recomendado)

1

Descarga desde la web

Descarga el archivo AtlasInstallerQt desde nuestra sección de descargas:

2

Hazlo ejecutable

$ chmod +x AtlasInstallerQt

3

Ejecuta el instalador Qt

$ ./AtlasInstallerQt

Método por Terminal

1. Abre una terminal

Presiona Ctrl + Alt + T o busca "Terminal" en tu menú de aplicaciones.

2. Navega a la carpeta de descargas

$ cd ~/Descargas

3. Descarga el instalador

$ wget -q --show-progress "https://github.com/adrianfb94/atlas-distribution/releases/latest/download/AtlasInstallerQt" -O AtlasInstallerQt

4. Hazlo ejecutable

$ chmod +x AtlasInstallerQt

5. Ejecuta el instalador

$ ./AtlasInstallerQt

1

Descarga el instalador Qt

El archivo AtlasInstallerQt es un ejecutable nativo de Qt5.

          Nombre: AtlasInstallerQt

          Tamaño: 211 KB

          Tipo: Ejecutable ELF con Qt5

          SHA256: [checksum disponible en la página]

2

Configura Permisos de Ejecución

Linux requiere permisos explícitos para ejecutar archivos. Si usas GUI, haz clic derecho → Propiedades → Permisos.

En terminal (recomendado):

$ chmod +x AtlasInstallerQt
# Esto agrega el permiso de ejecución

$ ls -la AtlasInstallerQt
# Deberías ver: -rwxr-xr-x ... AtlasInstallerQt
# La 'x' indica que es ejecutable

Error común: Si ves "Permiso denegado" al ejecutar, significa que no configuraste los permisos correctamente. Usa chmod +x.

3

Ejecuta el Instalador

$ ./AtlasInstallerQt
# El './' es necesario para ejecutar desde el directorio actual

Interfaz del instalador: Verás una ventana con:

Selector de carpeta de instalación
Barra de progreso de descarga (~20 GB total)
Información de espacio disponible
Opciones de instalación

Ubicación recomendada:
~/AtlasInteractivo/ (en tu carpeta home)
~/Apps/AtlasInteractivo/ (si tienes carpeta Apps)
/opt/AtlasInteractivo/ (si quieres acceso global, necesita sudo)

4

Descarga Automática del Contenido

El instalador Qt descargará los 20 GB desde Google Drive.

Características:

Formato .tar: Archivo sin compresión para ahorrar CPU
Extracción por partes: Requiere espacio extra de ~ 5GB
Espacio temporal requerido: Requiere 25GB
Espacio final ocupado: Al finalizar la descarga y la extracción, ocupará 20GB
Progreso visual: Barra de progreso en tiempo real
Verificación: Checksum SHA256 de todos los archivos

5

Finalización y Acceso

Cuando termine la instalación, tendrás estas opciones:

          Opciones al finalizar: ✓ Ejecutar Atlas Interactivo ahora ✓ Crear
          entrada en el menú de aplicaciones ✓ Crear acceso directo en
          escritorio ✓ Abrir carpeta de instalación
        

Estructura de archivos creada:

# Ejemplo de estructura:
~/AtlasInteractivo/
├── Atlas_Interactivo # Ejecutable principal
├── atlas.desktop # Entrada para el menú
├── icon.png # Icono de la aplicación
├── assets/ # 174k+ archivos de mapas
├── .version.json # Información de versión
└── README # Documentación

Para ejecutar manualmente:

$ ~/AtlasInteractivo/Atlas_Interactivo
# O usa el acceso creado en el menú de aplicaciones

Dependencias Qt (si faltan)

El instalador Qt necesita estas bibliotecas. La mayoría ya están instaladas en sistemas modernos:

# Ubuntu/Debian:
$ sudo apt install libqt5widgets5 libqt5gui5 libqt5core5a libqt5network5

# Fedora:
$ sudo dnf install qt5-qtbase qt5-qtbase-gui

# Arch Linux:
$ sudo pacman -S qt5-base

Uso Avanzado por Línea de Comandos

Argumentos Disponibles

$ ./AtlasInstallerQt --help
# Muestra todas las opciones disponibles

Argumento	Descripción	Ejemplo
`--help, -h`	Mostrar ayuda y salir	`./AtlasInstallerQt -h`
`--version, -v`	Mostrar versión y salir	`./AtlasInstallerQt --version`
`--check-updates`	Verificar actualizaciones	`./AtlasInstallerQt --check-updates`
`--install-dir PATH`	Especificar directorio de instalación*	`./AtlasInstallerQt --install-dir /opt/Atlas`
`--skip-desktop`	No crear accesos directos*	`./AtlasInstallerQt --skip-desktop`

Nota sobre argumentos:
Los argumentos marcados con (*) configuran opciones en la GUI pero no evitan que se abra la interfaz gráfica.
No existe --no-gui en esta versión - el instalador siempre abre la interfaz Qt.

Ejemplos Prácticos

Instalación en directorio específico:

$ ./AtlasInstallerQt --install-dir ~/Aplicaciones/Atlas
# Se abrirá el instalador GUI instalando en el directorio especificado

Instalación sin accesos directos:

$ ./AtlasInstallerQt --skip-desktop
# No creará íconos en escritorio ni menú de aplicaciones

Script de instalación automática:

#!/bin/bash
# Instalación automática básica
./AtlasInstallerQt --install-dir /opt/AtlasInteractivo --skip-desktop
# Nota: Requiere interacción manual en la GUI del instalador

Verificar instalación y versiones:

$ ./AtlasInstallerQt --version
$ ./AtlasInstallerQt --check-updates
# Estos funcionan sin abrir la GUI

Solución de Problemas

Error: "No se puede cargar la biblioteca Qt"

Instala las dependencias Qt:

# Para la mayoría de distribuciones:
$ sudo apt install qtbase5-dev # Ubuntu/Debian
$ sudo dnf install qt5-qtbase # Fedora

Error: "bash: ./AtlasInstallerQt: Permiso denegado"

$ chmod +x AtlasInstallerQt
# Si no funciona, prueba con:
$ sudo chmod +x AtlasInstallerQt

El instalador no se abre (sin errores)

Ejecuta en terminal para ver mensajes de error:

$ ./AtlasInstallerQt --debug

No hay suficiente espacio en disco

# Verifica espacio disponible:
$ df -h ~

# Necesitas al menos 15 GB libres. Para liberar espacio:
$ sudo apt autoremove # Ubuntu/Debian
$ sudo dnf autoremove # Fedora
$ sudo pacman -Sc # Arch

Problemas con SELinux (Fedora/RHEL)

# Temporalmente deshabilitar SELinux para la ejecución:
$ ./AtlasInstallerQt --appimage-extract
$ cd squashfs-root
$ ./AppRun

# O agregar contexto SELinux:
$ sudo chcon -t unconfined_exec_t AtlasInstallerQt

Sistema de Actualizaciones

Atlas Interactivo en Linux se actualiza automáticamente:

          Funcionamiento de actualizaciones: 1. La aplicación verifica versiones
          al iniciar 2. Descarga solo archivos modificados (MBs, no GBs) 3.
          Aplica parches automáticamente 4. Notifica cuando está lista
        

Actualización manual: Si necesitas forzar una actualización:

$ ~/AtlasInteractivo/Atlas_Interactivo --check-updates
# O elimina .version.json para forzar actualización completa

¡Instalación Completada!

Ahora puedes explorar el mundo con Atlas Interactivo en Linux.

Descargar para Linux

¿Necesitas ayuda? Visita nuestra sección de preguntas frecuentes o abre un issue en GitHub.

# Comando final para verificar instalación:
$ ~/AtlasInteractivo/Atlas_Interactivo --version
# Debería mostrar la versión instalada

Guía de Instalación para Linux