# FAQ

Perguntas frequentes sobre o BackupAlly.

# Geral

# O que é BackupAlly?

BackupAlly é um framework backup-as-code escrito em Rust. Permite configurar backups de bancos de dados e arquivos de forma declarativa usando arquivos TOML.

# Quais sistemas operacionais são suportados?

Atualmente, BackupAlly suporta Linux. Suporte para macOS e Windows está planejado.

# BackupAlly é gratuito?

Sim, BackupAlly é open source e gratuito para uso.

# Preciso de conhecimento em Rust?

Não. BackupAlly é distribuído como binário compilado. Você configura via arquivos TOML.

# Instalação

# Como instalar?

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

# Onde ficam os arquivos de configuração?

• Config global: /etc/backupally/config.toml
• Tasks: /etc/backupally/tasks.d/
• Chaves: /etc/backupally/keys/
• Secrets: /etc/backupally/secrets.db

# Como atualizar?

backupally update

Ou reinstale:

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

# Configuração

# Posso usar variáveis de ambiente?

Sim, use ${env:NOME_VARIAVEL}:

password = "${env:DB_PASSWORD}"

# Como armazenar senhas de forma segura?

Use o secrets store:

backupally secrets set db_password "minha-senha"

E referencie:

password = "${secret:db_password}"

# Posso fazer backup de múltiplos bancos?

Sim, use database = "*" para todos:

[target]
driver = "mysql"
database = "*"
excludes = ["mysql", "information_schema"]

# Como excluir arquivos do backup?

Use padrões glob em excludes:

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

# Segurança

# Meus backups são criptografados?

Sim, por padrão todos os backups usam:

• RSA-4096 para proteger a chave
• AES-256-GCM para criptografar dados

# O que acontece se eu perder a chave?

Sem a chave, os backups são irrecuperáveis. Recomendações:

• Faça backup da chave em local seguro
• Use o servidor central para backup de chaves
• Anote o fingerprint de cada chave

# Como rotacionar chaves?

backupally keys generate --name new-key
# Atualize tasks para usar nova chave
# Mantenha chave antiga para restaurar backups antigos

# Storage

# Posso usar múltiplos storages?

Sim, adicione múltiplas seções [[storage]]:

[[storage]]
id = "local"
driver = "local"
path = "/backup"

[[storage]]
id = "s3"
driver = "s3"
bucket = "my-bucket"

# Os uploads são paralelos?

Sim, backups são enviados para todos os storages simultaneamente.

# Como funciona a retenção?

Configure por storage:

retention = "daily 7, weekly 4, monthly 6"

Mantém:

• 7 backups diários
• 4 backups semanais
• 6 backups mensais

# Agendamento

# Como agendar backups?

Use expressão cron no campo schedule:

schedule = "0 2 * * *"  # Todo dia às 2:00

# Posso definir condições?

Sim, use a seção [condition]:

[condition]
when = "loadavg() < 2.0 && diskfree('/backup') > 50GB"

# O scheduler roda como serviço?

Sim:

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

# Restauração

# Como restaurar um backup?

backupally restore \
  --target mysql-prod \
  --snapshot snap_20260211_020000 \
  --path /restore

# Posso verificar integridade antes de restaurar?

Sim:

backupally restore --verify --target mysql-prod --snapshot snap_xxx

# E se o backup estiver em outro storage?

Especifique o storage:

backupally restore \
  --target mysql-prod \
  --snapshot snap_xxx \
  --storage b2-secondary \
  --path /restore

# Performance

# Backups estão lentos, o que fazer?

1. Use compressão mais rápida:

[packer]
compressor = "lz4"

2. Aumente limite de banda:

[network]
max_mbps = 200

3. Use backup incremental:

[collector]
incremental = true

# Qual algoritmo de compressão é melhor?

Recomendamos Zstd (padrão) para a maioria dos casos.

# MCP

# O que é MCP?

Model Context Protocol - permite integração com assistentes de IA como Claude.

# Como habilitar?

[mcp]
enabled = true

E configure no Claude Desktop ou Claude Code.

# O que posso fazer via MCP?

• Consultar status de backups
• Criar planos de backup guiados
• Diagnosticar problemas
• Configurar targets e agendamentos