Documentación de Surge

• Para quien instala software de terceros a menudo y está cansado de una instrucción distinta por cada proyecto.
• Para quien prueba aplicaciones de escritorio nuevas (AppImage, .deb, .rpm) sin convencerse de dejar basura en el sistema.
• Para quien mantiene un equipo familiar o de trabajo y quiere desinstalar con la conciencia tranquila.
• Para quien desarrolla y necesita tener varias versiones de una misma herramienta conviviendo sin conflictos.
• Para quien simplemente quiere una terminal más limpia, un sistema más limpio y menos tiempo perdido.

Instalar con sudo dpkg -i o con un instalador propietario normalmente funciona… hasta que quieres deshacerlo. Los problemas típicos son tres, y todos aparecen semanas después:

• Archivos huérfanos: el paquete deja bibliotecas y configuraciones en ubicaciones del sistema que nadie vuelve a consultar.
• Dependencias rotas: una aplicación trae la versión de una biblioteca de forma silenciosa y ese snippet rompe otra aplicación que la necesitaba.
• Conflictos de versiones: instalar la aplicación B modifica lo que usaba la aplicación A, y averiguar qué cambió es una investigación.

La desinstalación clásica no mira atrás: muchos gestores declaran "removed" pero dejan archivos de configuración, entradas de menú, cachés y servicios cargados. Surge fue creado para que esa situación deje de ser normal.

• No es un reemplazo de apt, dnf, pacman ni de tu gestor de repositorios.
• No es un administrador de contenedores ni una alternativa a Docker, Podman o Flatpak.
• No es una suite de virtualización: no existe este sandbox de una capa extra de abstracción.
• No es un instalador de sistema: nunca escribe en /usr, /opt, /etc ni en los binarios del mismo sistema.
• No es un catálogo: Surge no decide por ti qué instalar. Tú le das el archivo y él se ocupa.

Conocer los límites evita falsas expectativas. Surge hace una sola cosa y la hace bien: tomar un paquete y desplegarlo en tu espacio de usuario.

Usamos la palabra protocolo en serio: Surge no sigue una sola receta, sino una serie de acuerdos de comportamiento. Confía en que la entrada es un paquete binario (en cualquier formato conocido), la analiza y la transforma en un "plan de despliegue" para tu cuenta de usuario. Del mismo protocolo salen ocho resultados con cualquier formato: la instalación es consistente entre formatos.

Eso explica por qué aprender a usar Surge se reduce a aprender una sola interfaz: los comandos de la guía de uso. Da igual que el archivo sea .deb, .rpm o AppImage.

Linux tiene una convención: las aplicaciones de un usuario viven en su carpeta local (~/.local/) junto a sus binarios (bin/), bibliotecas (lib/), datos (share/) y otros recursos. Surge respeta esta convención: todo lo que coloca va exactamente donde Linux siempre ha querido que estén las cosas de un solo usuario.

Eso tiene consecuencias prácticas muy concretas: el mismo usuario puede tener "su" espacio limpio y ordenado aunque el sistema esté saturado, y la instalación no le pide permisos porque no sale de su espacio.

La lista se amplía con cada versión menor, pero no esperes soporte de la mañana a la noche para formatos muy nuevos o muy poco usados: el protocolo evoluciona con la oferta real de software.

Todo lo que instala Surge queda apuntado en un registro local que vive en tu propio espacio de usuario. Ese registro es lo que hace posible surge list, las desinstalaciones completas y esa garantía de que, al eliminar algo, no quede un "eco" en el sistema.

El registro es transparente: puedes consultar en cualquier momento qué aplicaciones hay, qué versión son y dónde vive cada archivo. Se puede considerar el contrato que Surge firma contigo para revertir cualquier cosa.

Uno de los mayores problemas de las instalaciones clásicas es la fragmentación: cada paquete duplica bibliotecas que otros ya tienen, acumula archivos que ya nadie usa y engancha dependencias invisibles. Surge aplica una lectura quirúrgica de binarios para saber qué es realmente externo y qué es interno del paquete: las dependencias externas se registran, las internas se quedan donde van. Así el sistema y tu espacio de usuario se mantienen limpios y sin rastros innecesarios.

Cuando termina el flujo, Surge hace tres cosas que se siguen notando con el uso:

• Integración con tu terminal: los comandos de lo instalado quedan disponibles en tu sesión sin que tengas que configurar nada más.
• Integración con el escritorio: las aplicaciones de escritorio aparecen en el menú de aplicaciones de tu entorno, si el entorno lo permite.
• Registro: la app queda apuntada en el registro local, con su versión y las rutas de sus archivos.

Repetir un comando surge install con el mismo paquete no genera duplicados ni errores: Surge reconoce que el software ya está e actualiza la instalación en su lugar. Si no quieres conservar nada de la versión anterior, la propia instalación reemplaza los archivos viejos de forma segura.

Si tu terminal no permite las tuberías, puedes descargar el instalador desde el sitio oficial, marcarlo como ejecutable y ejecutarlo:

chmod +x ./install.sh
./install.sh

Se trata de la única causa probable: tu PATH no incluye ~/.local/bin. En la mayoría de distribuciones modernas sí viene incluido; si no, agrégalo de forma persistente ~/.bashrc o en el equivalente de tu shell con:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Con esto los comandos instalados (el propio Surge y todo lo que instales con él) quedan disponibles en todas tus terminales.

surge self-update

Surge se actualiza a sí mismo de forma segura e incremental, sin volver a instalar lo que ya tienes con él. Si una actualización falla, se avisa y se intenta conservar la versión anterior.

surge remove --self

Esta acción elimina el binario de Surge y todos sus rastros locales. Lo que hayas instalado con Surge seguirá siendo gestionable con surge remove si decides volver a instalar el gestor, o de forma manual si prefieres desinstalarlas a mano.

1. 01Abre una terminal (Ctrl+Alt+T en la mayoría de escritorios).
2. 02Instala Surge con el comando del capítulo anterior.
3. 03Ejecuta surge --version para confirmar que responde.
4. 04Descarga el .deb, .rpm o AppImage de un proyecto que te interese.
5. 05Ejecuta surge install ruta/del/archivo y observa el flujo por primera vez.

Puedes pasar varios archivos en una sola invocación. El flujo de cada uno es independiente, así que un error en uno no detiene el resto:

surge install ./app.deb ./tool.AppImage ./binario.tar.gz

surge inspect ./app.deb
#   >> Mapa completo de destinos:
#     bin/app -> ~/.local/bin/app
#     lib/libxyz.so.1 -> ~/.local/lib/...

Es la mejor forma de saber exactamente qué hará Surge antes de comprometerse, perfecto para paquetes que traes de fuentes menos conocidas.

surge remove app
# ✓ app ya no está disponible
#   No quedaron restos en /usr ni /etc

La desinstalación marca la aplicación desde el registro y elimina los archivos que creó, incluidas las bibliotecas internas y los accesos del escritorio.

1. 01Crea una carpeta de práctica: mkdir ~/lab-surge y entra a ella.
2. 02Descarga el .deb de una aplicación que te guste (por ejemplo, un editor, una app de notas o una herramienta de diseño).
3. 03Ejecuta surge install ./aplicacion.deb. Observa el reconocimiento del formato y el mapa de rutas.
4. 04Ejecuta surge list para verla registrada con nombre y versión.
5. 05Ábrela desde el menú de aplicaciones o ejecuta su comando en la terminal.
6. 06Desinstálala con surge remove aplicacion y confirma que el acceso de menú y los comandos desaparecen.

1. 01Descarga cualquier AppImage de un proyecto (las distribuciones de herramientas como Obsidian, imágenes de análisis o utilidades aisladas suelen usarlo).
2. 02No hace falta hacerlo ejecutable: Surge lo trata como paquete.
3. 03Ejecuta surge install ./herramienta.AppImage.
4. 04Comprueba que aparece en tu menú de aplicaciones y que su binario funciona desde cualquier carpeta.
5. 05Regresa a casa: surge remove herramienta lo quita por completo.

1. 01Descarga una herramienta de línea de comandos distribuida como archivo suelto o .tar.gz (por ejemplo utilidades de desarrollo o de servidor).
2. 02Ejecuta surge install ./herramienta.tar.gz.
3. 03Si Surge detecta varios binarios, un paso interactivo te permite elegir cuál instalar.
4. 04Comprueba con surge list que quedó registrada y con surge info herramienta dónde vive.

Si quieres entender qué hace Surge en cada paso, usa la variante --verbose:

surge install --verbose ./app.deb
#   [reconocimiento] formato=deb arquitectura=amd64
#   [enrutado] bin/app → ~/.local/bin
#   [extracción] 14 archivos en ~/.cache/surge
#   [instalación] 14 piezas colocadas · registro ok

Surge no sustituye el juicio del usuario: quien descarga el paquete es quien decide de qué fuente confía. Lo que Surge aporta es visibilidad antes y después: puedes ver exactamente qué haría y, con la transparencia del registro, qué hizo. Es, en la práctica, un contrato de revertibilidad.

Por eso se recomienda usar surge inspect con paquetes procedentes de fuentes poco conocidas, igual que revisarías un script de instalación antes de leerlo.

1. 01Confirma que instaló: busca ~/.local/bin/surge con el comando indicado en el capítulo 6.
2. 02Si existe, es un problema de PATH: añade ~/.local/bin al PATH según el capítulo 6.
3. 03Si no existe, reejecuta la instalación. El script es idempotente.

1. 01Comprueba la conexión y los proxies: curl -fsSL https://example.com debe responder.
2. 02Si un proxy empresarial bloquea la tubería, usa la opción de instalación por navegador del capítulo 6.
3. 03Descarga el script a mano, revísalo y ejecútalo con sh ./install.sh o bash.

1. 01Revisa el nombre y la extensión: a veces la autoridad de descarga cambia el formato (por ejemplo, .tar.gz con nombre .zip).
2. 02Usa surge inspect para ver qué detectó exactamente.
3. 03Si es un formato no soportado el protocolo lo indica con claridad; envía el caso al Discord.

1. 01Espera unos segundos o reinicia la sesión del escritorio.
2. 02Comprueba con surge info nombre que los archivos de integración se registraron.
3. 03Algunos escritorios no indexan automáticamente nuevos íconos hasta la próxima sesión.

1. 01Ejecuta surge list y elimina aplicaciones que ya no uses.
2. 02Consulta el registro con surge info para ver si alguna app ocupa mucho.
3. 03El núcleo de Surge ocupa unos pocos MB; el grueso suele ser de lo instalado, no del gestor.

1. 01Surge intenta conservar la versión anterior; la app queda operativa.
2. 02Reintenta la instalación (es incremental y segura).
3. 03Si falla otra vez, reporta la salida completa del comando en los Issues.

• Estable: la versión recomendada para el día a día, probada en beta.
• Beta: versiones de prueba para curiosos. Se informa claramente de qué incluye cada versión.
• El canal lo eliges al instalar o cambiar la fuente; el cambio es reversible.

surge --version
# Surge 0.7.3

El estado del proyecto, sus release notes y el changelog se publican en las notas oficiales de cada lanzamiento.

Tres ingredientes hacen que cualquier consulta se resuelva rápido:

1. 01El contexto: qué distribución, qué arquitectura (comando uname -m).
2. 02El comando exacto que ejecutaste y la salida completa.
3. 03Una descripción corta de qué esperabas y qué pasó de verdad.

De verdad. Todo lo que instala usa tus propios privilegios de usuario. Ningún paso pide contraseña ni ajustes del sistema.

No. Surge no reemplaza a tu gestor de distribución: lo complementa. Para software del sistema y repositorios de la distro, usa el gestor nativo. Surge es para lo que el gestor no cubre bien: aplicaciones de terceros, binarios, AppImage y versiones personalizadas.

El sistema queda donde estaba. Surge mantiene el registro local de cada instalación y la desinstalación elimina los archivos que creó, sin dejar residuos. Si el paquete colocó un archivo en otra parte, se elimina igual con surge remove nombre.

Surge instala siempre en tu espacio de usuario y no mezcla archivos con el sistema. Puede convivir sin conflicto con lo ya instalado, ya sea con gestores de la distro o con instalaciones manuales.

Con los formatos habituales —.deb, .rpm,AppImage, .tar.gz y .zip— sí. Con formatos muy nuevos, cifrados o corruptos, puede que no: el protocolo solo trabaja con lo que puede leer. Ante cualquier caso extraño, pregunta en la comunidad.

Sí, sin ninguna limitación. Instala Surge en cada equipo donde lo necesites. No hay dispositivos vinculados, licencias por máquina ni registro de usuarios.

Funciona exactamente igual, incluso mejor: todo el despliegue es por línea de comandos. Para un servidor, la instalación de herramientas dentro de tu espacio de usuario convierte el despliegue en algo predecible.

Sí. Cada instalación tiene una contraparte: surge remove elimina lo que surge install creó. Y si dudas antes de dar el paso, surge inspect te muestra el plan completo sin ejecutar nada.

La filosofía es: hacer menos, copiar menos, usar menos. En los ensayos habituales, un paquete de escritorio se instala en instantes y puedes ver los números en el apartado de métricas de la portada.