Instalar a central

A central se instala sozinha: baixa o sistema do local, liga o túnel até o painel e começa a se reportar à Abriu. Há dois jeitos, e os dois usam o mesmo código de uso único que a Abriu entrega (veja O que o instalador recebe da Abriu).

Antes de ligar

• O código ou o arquivo de primeiro boot em mãos, dentro do prazo (14 dias desde a emissão). Vencido, a Abriu gera outro em minutos.
• Cabo de rede ligado ao roteador do local, com internet funcionando (veja O que a central acessa na internet).
• A fonte oficial do modelo (veja A central).
• Um computador com o Raspberry Pi Imager 2.0 ou mais novo, para o cartão.

Jeito 1: o cartão com o arquivo de primeiro boot

O mais simples: nada de teclado, tela ou comando.

1. No Raspberry Pi Imager, escolha o modelo do Pi e o sistema Raspberry Pi OS (64-bit), o com área de trabalho (não o Lite). Quando o Imager perguntar sobre personalização (usuário, Wi-Fi, SSH), responda não: o arquivo da Abriu faz isso.
2. Grave o cartão.
3. Com o cartão ainda no computador, abra a partição chamada bootfs (a única que o Windows e o macOS mostram) e substitua o arquivo user-data pelo que a Abriu enviou. Se a central for usar Wi-Fi, substitua também o network-config. Alguns navegadores salvam o user-data sem extensão e perguntam se querem manter: mantenha, e não renomeie.
4. Coloque o cartão na central, ligue o cabo de rede e, por último, a energia.
5. Espere de 10 a 20 minutos. O LED verde pisca enquanto a central trabalha.

Sem cabo de rede e sem o network-config, conecte o Wi-Fi pela área de trabalho da central (com tela e teclado): ela espera a internet e segue sozinha. Se faltar energia ou for preciso reiniciar no meio, ela continua no boot seguinte, até terminar.

O arquivo de primeiro boot tem o código de instalação dentro: até a central se instalar, guarde o cartão como guardaria o código.

Jeito 2: o comando, num Pi que já tem sistema

Para uma central que já tem o Raspberry Pi OS (64-bit) e acesso por teclado e tela ou SSH:

curl -fsSL https://fleet-api.abriu.app/install | sudo bash -s -- XXXX-XXXX-XXXX-XXXX

Troque os X pelo código. O comando instala tudo e termina com "Pronto.". Se falhar depois do download (rede, relógio), resolva a causa e rode o mesmo comando de novo: o código continua valendo até a instalação terminar.

Como saber que deu certo

1. O painel do local abre: https://<id>.abriu.app mostra a tela de login (antes disso, uma página de erro da Cloudflare).
2. O responsável recebe o e-mail para criar a senha do painel (confira o spam). Ele sai quando o sistema sobe na central.
3. A página de status, https://status.abriu.app/<id>, mostra o sistema no ar.
4. Para a Abriu, o local sai de "Aguardando instalação" na frota. Se quiser confirmar, mande uma mensagem ao suporte.

Nada disso em 30 minutos: veja A central não se instala.

Depois da instalação

• A central não precisa de mais nada: ela se atualiza sozinha (a Abriu controla quando) e se reporta a cada 5 minutos.
• Não desligue a central pela tomada no dia a dia; se precisar, desligue pelo painel ou avise a Abriu. Quedas de energia são esperadas e a central volta sozinha.
• Guarde a caixa fechada e fora do alcance (veja Onde instalar a central).
• O cartão com o arquivo de primeiro boot já foi consumido: o código não vale mais, mas o cartão fica na central.

Trocar ou reinstalar uma central

Se a central quebrar ou o cartão corromper, a Abriu gera um novo código e a central nova se instala do mesmo jeito. Os dados do local voltam do backup externo, que a central envia toda noite. O passo a passo, para a troca planejada e para a central que morreu, está em Trocar a central. Os terminais continuam funcionando enquanto a central está fora.