Guía de Instalación Linux - Atlas Interactivo

Distribuciones Compatibles

Atlas Interactivo funciona en cualquier distribución Linux moderna de 64-bit con soporte para Qt5.

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

20 GB libres

Entorno Gráfico

GNOME, KDE, XFCE, etc.

Nota sobre el instalador Qt: El archivo ha sido renombrado a .Appimage para facilitar la ejecución en Ubuntu 20+. Aunque el instalador tiene interfaz gráfica, requiere las bibliotecas Qt5 del sistema (generalmente preinstaladas). El contenido principal (~19 GB) se descargará durante la instalación.

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 AtlasInstaller.Appimage desde nuestra sección de descargas:

2

Hazlo ejecutable

$ chmod +x AtlasInstaller.Appimage

3

Ejecuta el instalador Qt

$ ./AtlasInstaller.Appimage

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 "http://modelos.insmet.cu/atlas/installers//AtlasInstaller.Appimage" -O AtlasInstaller.Appimage

4. Hazlo ejecutable

$ chmod +x AtlasInstaller.Appimage

5. Ejecuta el instalador

$ ./AtlasInstaller.Appimage

1

Descarga el instalador Qt

El archivo AtlasInstaller.Appimage es un ejecutable nativo de Qt5.

          Nombre: AtlasInstaller.Appimage

          Tamaño: 194 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 AtlasInstaller.Appimage
# Esto agrega el permiso de ejecución

$ ls -la AtlasInstaller.Appimage
# Deberías ver: -rwxr-xr-x ... AtlasInstaller.Appimage
# 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

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

Interfaz del instalador: Verás una ventana con:

Selector de carpeta: Donde se instalarán los ~19 GB de datos
Barra de progreso: Con porcentaje, velocidad y ETA
Información de espacio: Verificación automática de 20 GB libres
Opciones: Crear accesos directos en escritorio y menú
Registro: Log detallado del proceso 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 19 GB en modo streaming.

Características:

Streaming inteligente: Descarga y extrae simultáneamente
Reanudación precisa: Detecta archivos ya descargados
Progreso en tiempo real: Velocidad, ETA y porcentaje
Sin duplicación: No requiere espacio extra temporal

5

Proceso de Instalación Automática

El instalador realiza estos pasos automáticamente:

          1. Verificación de herramientas (curl, tar)

          2. Descarga de índices de archivos (.sizes, 22 MB)

          3. Cálculo de espacio y verificación de TAR

          4. Streaming con curl + tar (descarga y extracción simultánea)

          5. Verificación de archivos extraídos

          6. Creación de archivo de versión (.atlas_version.json)

          7. Configuración de permisos del ejecutable

          8. Creación de accesos directos (opcional)

Streaming con índices: El instalador usa un método donde verifica qué archivos ya están completos antes de continuar. Esto permite reanudaciones precisas si se interrumpe la instalación.

6

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

$ ./AtlasInstaller.Appimage --help
# Muestra todas las opciones disponibles

Argumento	Descripción	Ejemplo
`--help, -h`	Mostrar ayuda y salir	`./AtlasInstaller.Appimage -h`
`--version, -v`	Mostrar versión y salir	`./AtlasInstaller.Appimage --version`
`--check-updates`	Verificar actualizaciones	`./AtlasInstaller.Appimage --check-updates`
`--install-dir PATH`	Especificar directorio de instalación*	`./AtlasInstaller.Appimage --install-dir /opt/Atlas`
`--skip-desktop`	No crear accesos directos*	`./AtlasInstaller.Appimage --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:

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

Instalación sin accesos directos:

$ ./AtlasInstaller.Appimage --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
./AtlasInstaller.Appimage --install-dir /opt/AtlasInteractivo --skip-desktop
# Nota: Requiere interacción manual en la GUI del instalador

Verificar instalación y versiones:

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

Solución de Problemas

Error: "No se puede cargar la biblioteca Qt"

Instala las dependencias Qt:

# 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

Error: "bash: ./AtlasInstaller.Appimage: Permiso denegado"

$ chmod +x AtlasInstaller.Appimage
# Si no funciona, prueba con:
$ sudo chmod +x AtlasInstaller.Appimage

Error: "curl: command not found"

$ sudo apt install curl # Ubuntu/Debian
$ sudo dnf install curl # Fedora
$ sudo pacman -S curl # Arch

Error: "tar: command not found"

# Tar generalmente viene preinstalado, pero si falta:
$ sudo apt install tar # Ubuntu/Debian

El instalador no se abre (sin errores)

Ejecuta en terminal para ver mensajes de error:

$ ./AtlasInstaller.Appimage --debug

No hay suficiente espacio en disco

# Verifica espacio disponible:
$ df -h ~

# Necesitas al menos 20 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:
$ ./AtlasInstaller.Appimage --appimage-extract
$ cd squashfs-root
$ ./AppRun

# O agregar contexto SELinux:
$ sudo chcon -t unconfined_exec_t AtlasInstaller.Appimage

¡Instalación Completada!

Descargar para Linux

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

Guía de Instalación para Linux