Skip to main content
Instala e atualiza o gateway. O painel de controle tem seu próprio instalador — fireflo-panel-install.

Os cinco verbos

“Pacotes” significa as dependências do próprio instalador, não os serviços com os quais o FireFlo conversa. Ele instala curl, openssl, rsync, python3 e o cliente PostgreSQL — nunca um servidor PostgreSQL, nunca um broker, e nunca Node. Em um host vazio, rode o setup.sh primeiro.
install recusa quando um diretório de configuração já existe, em vez de emitir um segundo par de tokens operacionais por cima do primeiro. Se você tem configuração mas nenhum serviço, o verbo que você quer é service, não install.Essa recusa se baseia em $CONF_DIR/fireflo.env, então ela não dispara quando você instala o mesmo tenant em um caminho diferente. Uma execução dessas chega a gerar um segundo par de tokens antes de a etapa da unidade recusar pela colisão de nome. Remova a instalação antiga primeiro — veja Removendo um tenant.
Não existe um verbo uninstall. A remoção é manual, e um tenant é mais unidades do que parece: o gateway escreve fireflo-<name>.service mais um par -logclean.timer e -logclean.service.

Opções que vale conhecer

Layout e identidade

Ambas as unidades geradas montam um tmpfs sobre /home e fazem bind apenas do único virtualhost, de forma que um gateway não consegue enxergar o diretório home de nenhum outro cliente. Isso é um namespace, não uma permissão: o próprio modo do diretório ainda decide quem pode entrar nele, e é por isso que --user importa acima.
Cada flag aceita um valor separado por espaço. --vhost=/home/acme é rejeitado como opção desconhecida em vez de ser interpretado.

Configuração e banco de dados

Comportamento

Executando

--dry-run mostra menos do que você poderia esperar. Ele não consegue reportar o que um gerenciador de pacotes puxaria, nem o que uma migração encontraria em um banco ao qual ainda não se conectou. Leia-o como “as decisões que este script tomaria”, não como “tudo o que mudaria neste host”.

O que ele não instala

O painel de controle. Isso é o fireflo-panel-install, e em um host novo você roda os dois. --log-retain-days escreve uma regra tmpfiles.d que apaga logs rotacionados, sem nunca tocar nos quatro em uso. Instalar manualmente significa arranjar isso você mesmo — veja Logging. Veja Instalar em um comando para o passo a passo.