# Instalação e Primeiro Backup

Este guia mostra como instalar o BackupAlly e executar seu primeiro backup.

# Instalação Rápida

Execute o instalador automático:

curl -fsSL https://get.backupally.com/quick-install.sh | sudo bash

O script automaticamente:

1. Detecta a arquitetura do sistema (x86_64 ou aarch64)
2. Baixa o binário mais recente (statically linked, zero dependências)
3. Instala em /opt/backupally/ com symlink em /usr/local/bin/
4. Cria a estrutura de diretórios
5. Executa o wizard de inicialização
6. Gera a chave de criptografia

# Instalação Manual

# 1. Download do Binário

Binários statically linked (musl) — rodam em qualquer Linux sem dependências.

# Detectar arquitetura e baixar
ARCH=$(uname -m)  # x86_64 ou aarch64
curl -fsSL -o /tmp/backupally.zip \
  "https://github.com/devborlot/backupally-client/releases/latest/download/backupally-${ARCH}.zip"
unzip -o /tmp/backupally.zip -d /tmp/

# Instalar em /opt/backupally com symlink
sudo install -d /opt/backupally
sudo install -m 755 /tmp/backupally /opt/backupally/backupally
sudo ln -sf /opt/backupally/backupally /usr/local/bin/backupally

# 2. Criar Estrutura de Diretórios

sudo mkdir -p /etc/backupally/tasks.d
sudo mkdir -p /var/lib/backupally/{catalog,temp,keys}
sudo mkdir -p /var/log/backupally

# 3. Inicializar

Execute o wizard interativo:

sudo backupally init

O wizard configura:

• Diretórios de trabalho
• Chave de criptografia RSA-4096
• Arquivo de configuração base

# 4. Verificar Instalação

backupally -V
# backupally 0.27.2

# Upgrade

O caminho recomendado é o self-update, que baixa a versão mais recente do canal estável, verifica a assinatura Ed25519 do binário e só então substitui a instalação:

# Atualizar para a versão mais recente
sudo backupally self-update

# Reinstalar a versão atual (útil para reparar instalação)
sudo backupally self-update --force

# JSON para automação
sudo backupally self-update -o json

Saída esperada:

✓ Assinatura verificada
Verificando binário...

✅ Atualização concluída!
Nova versão: backupally 0.27.2

O comando também existe como backupally install upgrade, com detecção automática de arquitetura.

Depois de atualizar, reinicie o serviço: o processo em execução continua rodando o binário antigo até ser reiniciado.

sudo systemctl restart backupally

Com backup em andamento, o self-update adia (desde 0.26.0): ele diz qual backup está rodando e há quanto tempo, e não troca o binário. Rode de novo depois, ou use --force se souber o que está fazendo. --check não é afetado.

Instalado antes da 0.27.1? Rode sudo backupally install-service uma vez para reescrever a unit com SyslogIdentifier=backupally — sem isso o journalctl -t backupally depende do nome do processo.

Para verificar à mão um binário baixado fora do self-update, ver Verificação do binário de release.

# Primeiro Backup

# Backup Rápido de Arquivos

O comando quick executa backups ad-hoc sem configuração:

backupally quick /var/www/html -d /backups/ -z

Opções utilizadas:

# Backup para S3

backupally quick /data -d s3://my-bucket/backups/ -t s3 \
  --access-key AKIAIOSFODNN7EXAMPLE \
  --secret-key wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY \
  --bucket my-bucket \
  --region us-east-1 \
  -z

# Backup para Backblaze B2

backupally quick /data -d b2://my-bucket/ -t b2 \
  --access-key 00212345678901234567890 \
  --secret-key K001AbCdEfGhIjKlMnOpQrStUvWxYz \
  --bucket my-bucket \
  -z

# Criar Primeira Task

Tasks são backups configurados que podem ser agendados.

# 1. Criar Task Interativamente

backupally task create

O wizard guia você pelas opções:

• Tipo de backup (database, fileset)
• Origem dos dados
• Destino (storage)
• Agendamento

# 2. Criar Task Manualmente

Crie um arquivo em /etc/backupally/tasks.d/:

sudo nano /etc/backupally/tasks.d/website-backup.toml

Conteúdo do arquivo:

[task]
id = "website-backup"
name = "Backup do Website"
enabled = true
schedule = "0 3 * * *"

[target]
kind = "fileset"
includes = ["/var/www/html"]
excludes = ["**/node_modules", "**/.git"]

[packer]
compressor = "zstd"
compression_level = 6

[[storage]]
id = "local"
driver = "local"
path = "/backups/website"
retention = "daily 7, weekly 4"

# 3. Validar Task

backupally task validate website-backup

# 4. Executar Task Manualmente

backupally backup --target website-backup

# 5. Listar Tasks

backupally task list

# Iniciar o Scheduler

Para executar backups automaticamente conforme o agendamento:

backupally scheduler start

Para rodar como serviço systemd:

sudo systemctl enable backupally-scheduler
sudo systemctl start backupally-scheduler

# Verificar Backups

# Listar Histórico

backupally history

# Ver Status

backupally status

# Estrutura de Diretórios

Após a instalação, a estrutura fica:

/etc/backupally/
├── config.toml          # Configuração global
├── tasks.d/             # Tasks individuais
│   └── website-backup.toml
├── keys/
│   └── default.key      # Chave RSA-4096
└── secrets.db           # Secrets criptografados

/var/lib/backupally/
├── catalog/             # Catálogo de backups
├── temp/                # Arquivos temporários
└── metadata/            # Metadados

/var/log/backupally/
└── backupally.log       # Logs

# Próximos Passos

• Backup de MySQL - Configure backup de banco de dados
• Múltiplos Storages - Envie para S3 e B2 simultaneamente
• Agendamento - Configure horários e condições
• Restauração - Recupere backups