Implant Documentação 8de3f8d

implant install

Instala aplicacoes complementares. Todos os downloads sao arch-aware (detectam automaticamente x86_64 ou aarch64) e verificados por TLS pinning e/ou assinatura minisign.

Uso 

implant install <APP> [OPTIONS]

Apps Disponiveis

App Descricao Destino
node Node.js via NVM ~/.nvm/
claude-code Claude Code CLI (requer Node.js) ~/.local/bin/claude
sysinfo Monitoramento de sistema /opt/sysinfo/sysinfo
backupally Sistema de backup /opt/backupally/backupally
container Runtime de containers (requer token) /opt/container/container
deployally Gerenciamento de deploys /opt/deployally/deployally
runner CI/CD Runner /opt/runner/runner

Os binarios instalados em /opt/{app}/{app} ganham um symlink em /usr/local/bin/{app}. Instalacoes antigas diretamente em /usr/local/bin/{app} continuam sendo reconhecidas.

Subcomandos e Flags

node

Instala Node.js via NVM.

implant install node [--version <VER>]
Flag Descricao Padrao
--version <VER> Versao do Node.js. Nao tem forma curta: -v e o --verbose global 20

claude-code

Instala o Claude Code CLI. Requer Node.js previamente instalado.

implant install claude-code

Utiliza o instalador nativo oficial: curl -fsSL https://claude.ai/install.sh | bash

sysinfo

Instala o agente de monitoramento de sistema.

implant install sysinfo

backupally

Instala o sistema de backup BackupAlly.

implant install backupally

container

Instala o runtime de containers. Requer token de autenticacao.

implant install container --token <TOKEN>
Flag Descricao Obrigatorio
-t, --token <TOKEN> Token de autenticacao (env: CONTAINER_TOKEN) Sim

deployally

Instala o gerenciador de deploys DeployAlly.

implant install deployally

runner

Instala o CI/CD Runner.

implant install runner

Exemplos

Instalar Node.js 20 

implant install node

Instalar Node.js versao especifica 

implant install node --version 22

Instalar Claude Code 

implant install claude-code

Instalar Container com token 

implant install container --token meu-token-123

Instalar DeployAlly 

implant install deployally

Instalar Runner 

implant install runner

Processo de Instalacao

Para cada app, o Implant:

  1. Detecta a arquitetura do sistema (x86_64 ou aarch64)
  2. Constroi a URL de download com a arquitetura correta
  3. Verifica o certificado TLS via pinning (SPKI) antes do download
  4. Baixa o binario para um temporario no proprio diretorio de destino (/opt/{app}/.{app}.new.<pid>), fora do /tmp
  5. Verifica se o binario e valido (--version)
  6. Define permissoes 755
  7. Substitui o binario com rename atomico — o binario nunca fica ausente no meio da troca
  8. Cria o symlink em /usr/local/bin/{app}

Seguranca

  • Arch-aware: downloads automaticamente adaptados a arquitetura do servidor
  • TLS Pinning: certificados verificados via hash SPKI embutido no binario, protegendo contra ataques MITM
  • Assinatura minisign: obrigatoria quando o download vem de um host sem pin embutido (por exemplo, uma URL alternativa configurada)
  • Validacao: cada binario e testado com --version antes de ser instalado

URLs Alternativas

As URLs de download e os caminhos de instalacao podem ser sobrescritos por app na secao [endpoints.apps] do config.toml ({arch} e substituido pela arquitetura):

[endpoints.apps.runner]
url = "https://downloads.example.com/{arch}/runner"
path = "/opt/runner/runner"