# Configuração Global

O arquivo config.toml contém a configuração global do BackupAlly.

# Localização

/etc/backupally/config.toml

# Estrutura Completa

[global]
local_pipeline_path = "/etc/backupally/pipeline"
default_temp_path = "/var/lib/backupally/temp"
remote_pipeline_url = "https://repository.backupally.com/"
remote_pipeline_auth = true
remote_pipeline_apikey = "xxxxxxxxxxxxxx"
chunk_algo = "fastcdc"
avg_chunk_mb = 8
max_concurrent_backups = 2
backup_verification = true

[logging]
level = "info"
format = "json"
destination = "file"
file_path = "/var/log/backupally/backupally.log"
rotate = "daily"
max_files = 14
log_retention_days = 30

[crypto]
key_mode = "default"
default_key_src = "file"
default_key_ref = "/etc/backupally/keys/default.key"

[network]
max_global_mbps = 100
retry_policy = "exponential"
max_retries = 3
timeout_seconds = 300

[sys]
enabled = false
url = "https://sys.backupally.com"
agent_id = "agent_prod_001"
api_key = "ak_xxxxxxxxxxxxx"
polling_interval_seconds = 60

[central]
enabled = false
server_url = "https://central.backupally.io"
api_key = "seu-api-key"
auto_sync = true
sync_interval = 3600

[mcp]
enabled = false
socket_path = "/var/run/backupally/mcp.sock"

# Seções

# [global]

Configurações gerais do sistema.

Estado saiu do /tmp (0.33.0). default_temp_path, o histórico (/var/lib/backupally/logs, desde a 0.25.0) e a cópia de segurança pré-restore de banco (/var/lib/backupally/restore_backups) moram fora de /tmp — nesses servidores /tmp é tmpfs: arquivo parado ali ocupa RAM enquanto existe e some no reboot, o oposto do que se quer de um registro de backup. Instalação existente com dado no lugar antigo é migrada automaticamente na primeira execução, só quando o destino novo está vazio. Sem permissão em nenhum diretório persistente, o legado ainda é usado, mas com aviso de que é volátil. | backup_verification | bool | true | Verificar após upload |

# [logging]

Configuração de logs.

# [crypto]

Configuração de criptografia.

Modos de chave:

# [network]

Configuração de rede.

# [guard]

Prevenções (desde 0.26.0). Tudo opcional: ausente = sem limite, que é o comportamento histórico.

[guard]
max_load_normalized = 1.5
min_free_memory_mb = 512
min_free_disk_gb = 5

Um backup não começa com a máquina acima de qualquer limite. A mensagem diz o recurso, o valor medido e o limite:

servidor sobrecarregado: load average (1m) em 3.10 (limite: 1.50)

Independente desses limites, o [guard] também impede o self-update de trocar o binário com backup em andamento — ver Upgrade.

# [sys]

Integração com backend centralizado.

# [central]

Servidor central para backup de chaves.

# [mcp]

MCP Server para integração com AI.

# Exemplos

# Configuração Mínima

[global]
local_pipeline_path = "/etc/backupally/tasks.d"

[logging]
level = "info"

[crypto]
key_mode = "default"
default_key_ref = "/etc/backupally/keys/default.key"

# Configuração de Produção

[global]
local_pipeline_path = "/etc/backupally/tasks.d"
max_concurrent_backups = 4
backup_verification = true

[logging]
level = "info"
format = "json"
destination = "file"
file_path = "/var/log/backupally/backupally.log"
rotate = "daily"
max_files = 30

[crypto]
key_mode = "default"
default_key_ref = "/etc/backupally/keys/production.key"

[network]
max_global_mbps = 500
max_retries = 5
timeout_seconds = 600

[central]
enabled = true
server_url = "https://central.backupally.io"
api_key = "${secret:central_api_key}"
auto_sync = true

# Validação

Verifique a configuração:

backupally config verify

# Recarregar

O scheduler detecta mudanças automaticamente. Para forçar:

sudo systemctl reload backupally-scheduler