Biblioteca de apps — zeltro install

zeltro install <app> [name] implanta um app pronto de terceiros, totalmente configurado e rodando, normalmente em menos de dois minutos. Abra-o no endereço que o zeltro status <app> mostra.

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 criar a estrutura de um projeto que você mesmo escreve, veja Frameworks. Se usar o comando errado, o Zeltro indica o certo.

O que um instalador faz por você#

Cada instalador resolve as particularidades de um app uma única vez, para que você (ou o seu agente) nunca precise descobri-las de novo:

• Cria o banco de dados do app no serviço compartilhado, além de um usuário de banco de dados próprio quando o app se recusa a rodar como root
• Gera segredos e chaves do app
• Escreve um arquivo compose conectado aos serviços compartilhados do Zeltro, em vez de bancos de dados embutidos
• Dá ao app um IP estático na rede do Zeltro, um nome de contêiner pelo qual os outros contêineres podem acessá-lo e uma porta publicada no host (o último número do IP) para o endereço LAN
• Aponta a URL do próprio app para esse IP antes da primeira inicialização (veja abaixo)
• Inicia o contêiner e espera até ele responder por HTTP

A URL do próprio app#

A maioria dos apps precisa saber a sua URL pública (APP_URL, ROOT_URL, NEXTAUTH_URL e assim por diante), e muitos redirecionam você para ela ou recusam qualquer outro endereço. O Zeltro não escreve no /etc/hosts, então o nome do projeto não é uma URL que o seu navegador consiga abrir. Antes da primeira inicialização do app, o zeltro install define essa URL como o IP do contêiner do projeto: http://grafana/ vira http://10.247.177.124/.

Usamos o IP, e não uma porta em localhost, porque ele funciona tanto no seu navegador no Linux quanto a partir de outros contêineres, em qualquer sistema operacional. Os apps que verificam o próprio nome de host (os domínios confiáveis do Nextcloud e do ownCloud, Kimai, Readeck, ESPHome, Baby Buddy, Healthchecks) aceitam tanto o IP quanto o nome do projeto.

Alguns apps têm um endereço que faz parte da sua identidade permanente, então o Zeltro o deixa como o nome do projeto:

• O Mastodon mantém LOCAL_DOMAIN e WEB_DOMAIN com o nome, e lista o IP em ALTERNATE_DOMAINS para responder também nele. As páginas inicial e de exploração carregam pelo IP, mas o Mastodon pressupõe HTTPS em produção: os cookies dele são marcados como Secure, e o navegador não os envia por http:// simples, e alguns redirecionamentos (do cadastro para o login, por exemplo) apontam para https://. Para fazer login, você precisa de HTTPS na frente dele.
• O Lemmy mantém hostname em lemmy.hjson com o nome. A interface web dele fala com a API pelo IP.
• O Pixelfed é a exceção: ele só serve páginas em APP_DOMAIN, então esse valor é definido como o IP.

Os instaladores mais novos fixam as tags das imagens em versões específicas, e não em :latest, para que uma instalação que funcionou ontem funcione igual hoje e as atualizações sejam intencionais. Alguns instaladores mais antigos ainda usam tags flutuantes; veja Apps disponíveis.

Opções#

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

Removendo um 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

O --force-db-delete apaga o que o app realmente usa, e não um banco de dados com o nome do projeto. Ele lê os nomes dos bancos de dados e dos usuários nos arquivos compose e .env do projeto, e nas linhas CREATE DATABASE / CREATE USER do instalador que o criou. Assim, remover zeltro install freescout helpdesk apaga o banco de dados freescout e o usuário freescout do MariaDB. Um banco de dados ou usuário que também apareça nos arquivos de outro projeto é mantido, e a saída avisa.

Mantendo os instaladores atualizados#

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

Os dois geram um prompt pronto que manda um agente buscar a versão upstream, comparar com o instalador atual, regenerá-lo, verificá-lo de ponta a ponta e fazer o commit.

Apps disponíveis#

São 214 apps. Sendo franco sobre o que foi e o que não foi verificado, porque "mais de 200 apps" é fácil de dizer e difícil de sustentar:

• 125 foram instalados em uma máquina real, verificados por HTTP e removidos — 114 adicionados na ampliação do catálogo de 2026-08, mais 11 mais antigos testados por amostragem desde então. Todos eles fixam as imagens em versões específicas.
• 89 são entradas mais antigas, anteriores a esse processo. Foram escritas e usadas, mas não passaram por ele, e a maioria ainda segue tags flutuantes como :latest. Podem muito bem funcionar; só que ninguém comprovou isso recentemente.

Se um app mais antigo se comportar mal, avise — é o jeito mais rápido de ele ser corrigido.

Achou um erro nesta tradução? Avise a gente no GitHub.