Biblioteca de apps: zeltro install

zeltro install <app> [name] despliega una app de terceros ya terminada, totalmente configurada y en marcha, normalmente en menos de dos minutos. Ábrela en la dirección que muestra zeltro status <app>.

zeltro install grafana       # monitoring dashboards
zeltro install gitea         # self-hosted git
zeltro install n8n           # workflow automation
zeltro install nextcloud     # file hosting
zeltro install --list        # everything available

Para crear la base de un proyecto que escribes tú, consulta Frameworks. Si te equivocas de comando, Zeltro te indica el correcto.

Lo que un instalador hace por ti#

Cada instalador resuelve una sola vez las particularidades de una app, para que ni tú ni tu agente tengan que volver a averiguarlas:

• Crea la base de datos de la app en el servicio compartido, y además un usuario de base de datos propio cuando la app se niega a ejecutarse como root
• Genera los secretos y las claves de la app
• Escribe un archivo compose conectado a los servicios compartidos de Zeltro en lugar de bases de datos incluidas
• Le da a la app una IP fija en la red de Zeltro, un nombre de contenedor con el que otros contenedores pueden llegar a ella y un puerto publicado en el host (el último número de la IP) para la dirección LAN
• Apunta la URL propia de la app a esa IP antes de su primer arranque (ver abajo)
• Arranca el contenedor y espera hasta que responda por HTTP

La URL propia de la app#

La mayoría de las apps necesitan conocer su URL pública (APP_URL, ROOT_URL, NEXTAUTH_URL, etc.), y muchas te redirigen a ella o rechazan cualquier otra dirección. Zeltro no escribe en /etc/hosts, así que el nombre del proyecto no es una URL que tu navegador pueda abrir. Antes del primer arranque de la app, zeltro install fija esa URL en la IP del contenedor del proyecto: http://grafana/ pasa a ser http://10.247.177.124/.

Se usa la IP y no un puerto de localhost porque funciona tanto desde tu navegador en Linux como desde otros contenedores en cualquier sistema operativo. Las apps que comprueban el propio nombre de host (los dominios de confianza de Nextcloud y ownCloud, Kimai, Readeck, ESPHome, Baby Buddy, Healthchecks) aceptan tanto la IP como el nombre del proyecto.

Algunas apps tienen una dirección que forma parte de su identidad permanente, así que Zeltro la deja como el nombre del proyecto:

• Mastodon mantiene LOCAL_DOMAIN y WEB_DOMAIN con el nombre, y añade la IP a ALTERNATE_DOMAINS para que también responda ahí. Sus páginas de inicio y de exploración cargan en la IP, pero Mastodon da por hecho HTTPS en producción: sus cookies llevan la marca Secure, que un navegador no envía por http:// sin cifrar, y algunas redirecciones (del registro al inicio de sesión, por ejemplo) apuntan a https://. Para iniciar sesión necesitas HTTPS delante.
• Lemmy mantiene hostname en lemmy.hjson con el nombre. Su interfaz web habla con la API en la IP.
• Pixelfed es la excepción: solo sirve páginas en APP_DOMAIN, así que ese valor se fija en la IP.

Los instaladores más nuevos fijan las etiquetas de imagen en versiones concretas, no en :latest, así que una instalación que funcionó ayer funciona igual hoy y las actualizaciones son deliberadas. Algunos instaladores antiguos todavía usan etiquetas variables; consulta Apps disponibles.

Opciones#

zeltro install livewire sign-tools
zeltro install livewire sign-tools --image canebaycomputers/cbc:nginx-php8-vector

Eliminar una app#

zeltro remove grafana                    # stop it and trash the files; data is kept
zeltro remove grafana --force-db-delete  # also drop its databases, DB users and volumes

--force-db-delete elimina lo que la app usa de verdad, no una base de datos con el nombre del proyecto. Lee los nombres de las bases de datos y los usuarios en los archivos compose y .env del proyecto, y en las líneas CREATE DATABASE / CREATE USER del instalador que lo creó. Así, al eliminar zeltro install freescout helpdesk se eliminan la base de datos freescout y el usuario freescout de MariaDB. Una base de datos o un usuario que también aparece en los archivos de otro proyecto se conserva, y la salida lo indica.

Mantener los instaladores al día#

zeltro update-installer <app>     # refresh one against current upstream, via AI
zeltro update-installer --all
zeltro create-installer "<idea>"  # write a brand-new installer, via AI

Los dos generan una instrucción preparada que le pide a un agente descargar la versión original, compararla con el instalador actual, regenerarlo, verificarlo de principio a fin y hacer commit.

Apps disponibles#

Hay 214 apps. Vamos a ser claros sobre qué se ha comprobado y qué no, porque "más de 200 apps" es fácil de decir y difícil de sostener:

• 125 se han instalado en un equipo real, se han comprobado por HTTP y se han eliminado: 114 añadidas en la ampliación del catálogo de 2026-08, más 11 antiguas revisadas desde entonces. Todas ellas fijan sus imágenes en versiones concretas.
• 89 son entradas antiguas, anteriores a ese proceso. Se escribieron y se usaron, pero no han pasado por él, y la mayoría todavía sigue etiquetas variables como :latest. Puede que funcionen perfectamente; nadie lo ha demostrado hace poco.

Si una app antigua da problemas, avísanos: es la forma más rápida de que se arregle.

¿Encontraste un error en esta traducción? Avísanos en GitHub.