Instalar o Frost

O Frost se instala com um único comando no macOS, no Linux e no Windows. Cada versão traz o próprio ambiente de execução, então não é preciso instalar mais nada antes.

#Sistemas compatíveis

Não existe pacote para ARM de 32 bits, como os sistemas Raspberry Pi mais antigos. No Windows, o WSL instala o pacote do Linux.

#O instalador

No macOS ou no Linux, execute isto em um terminal:

curl -fsSL https://getfro.st/install.sh | sh

No Windows, execute isto no PowerShell:

irm https://getfro.st/install.ps1 | iex

O instalador:

1. Baixa a versão mais recente para o seu sistema.
2. Confere a assinatura da versão e a soma de verificação do download, e para se alguma estiver errada.
3. Instala o Frost no seu perfil de usuário e coloca um inicializador frost em uma pasta do seu PATH.

No macOS e no Linux, ele precisa de curl ou wget, do ssh-keygen do OpenSSH 8.1 ou mais recente, e de sha256sum ou shasum para as verificações. No Windows, ele precisa do Windows PowerShell 5.1, que vem com o Windows 10 e 11, ou do PowerShell 7. Ele confere a assinatura com o runtime que vem na própria versão, depois que o Windows confirma que a OpenJS Foundation assinou esse runtime.

No macOS e no Linux, o inicializador vai para /usr/local/bin se você tiver permissão de escrita ali, e para ~/.local/bin se não tiver. Se essa pasta ainda não estiver no seu PATH, o instalador mostra a linha que a adiciona. No Windows, o inicializador vai para %LocalAppData%\frost\bin, e o instalador adiciona essa pasta ao seu PATH. Terminais que já estavam abertos precisam ser reabertos para encontrar o frost.

O instalador com curl também funciona no Git Bash no Windows. Ali ele precisa do cygpath, que o Git Bash fornece, extrai com unzip ou PowerShell, e coloca o inicializador em ~/bin.

Quando terminar, execute frost init para configurar o seu primeiro backup. Veja Configurar o Frost.

#Opções do instalador

Por exemplo, no macOS ou no Linux:

curl -fsSL https://getfro.st/install.sh | FROST_INSTALL_DIR="$HOME/bin" sh

No Windows, defina a variável antes, na mesma janela do PowerShell:

$env:FROST_VERSION = 'v0.1.0'; irm https://getfro.st/install.ps1 | iex

Mudar a pasta do inicializador não move o Frost em si. Arquivos e pastas mostra onde fica cada coisa.

#Com npm ou pnpm

Se você já tem o Node.js 22 ou mais recente, pode instalar o Frost com o npm:

npm install -g getfrost

Ou com o pnpm:

pnpm add -g getfrost

O pacote se chama getfrost, e o comando que ele oferece é frost. Na primeira vez que você executa frost, ele baixa a versão para o seu sistema, confere a assinatura e a soma de verificação como o instalador faz, e a instala no seu perfil de usuário. Depois executa o seu comando. A partir daí, todo comando frost vai direto para o Frost instalado, que se mantém atualizado sozinho.

Com o pnpm, execute pnpm setup antes, se nunca tiver feito isso, para que os comandos globais do pnpm fiquem no seu PATH.

#Instalar manualmente

1. Baixe o arquivo compactado para o seu sistema na versão mais recente. Os nomes são parecidos com frost_0.1.0_linux_amd64.tar.gz, com .zip no Windows.
2. Verifique o download antes de executar qualquer coisa dele, como mostra a seção "Verificar um download", mais abaixo.
3. Extraia o conteúdo em uma pasta nova e vazia.
4. Dentro da pasta extraída, execute o instalador incluído e informe a pasta do inicializador.

No macOS ou no Linux:

./runtime/bin/node install.mjs "$PWD" "$HOME/.local/bin"

No Windows, no PowerShell:

.\runtime\bin\node.exe .\install.mjs "$PWD" "$env:LOCALAPPDATA\frost\bin"

Depois, adicione a pasta do inicializador ao seu PATH, se ela ainda não estiver lá. No Windows, o frost.cmd funciona no Prompt de Comando e no PowerShell, e o frost funciona no Git Bash.

Para rodar um pacote extraído sem instalar, use diretamente o inicializador frost dele (frost.cmd no Windows) e mantenha todos os arquivos juntos.

#Verificar um download

O instalador faz isso por você. Para conferir um arquivo compactado por conta própria, baixe-o junto com checksums.txt e checksums.txt.sig da mesma versão, e baixe release-signing.pub do repositório. Coloque em archive o nome do arquivo compactado e execute:

(
  set -e
  archive='frost_X.Y.Z_linux_amd64.tar.gz'
  printf 'frost-release %s\n' "$(cat release-signing.pub)" > allowed_signers
  ssh-keygen -Y verify -f allowed_signers -I frost-release -n file -s checksums.txt.sig < checksums.txt
  selected_checksum=$(awk -v archive="$archive" '$2 == archive { line = $0; count++ } END { if (count != 1) exit 1; print line }' checksums.txt)
  printf '%s\n' "$selected_checksum" | shasum -a 256 -c -
)

Os comandos param se a assinatura estiver incorreta ou se a lista assinada não tiver exatamente uma entrada para o seu arquivo. A primeira verificação deve mostrar Good "file" signature, e a segunda deve mostrar OK depois do nome do seu arquivo. Se alguma não mostrar, não instale.