---
title: Backup and restore
description: Faça um backup consistente dos dados e da configuração do NexCMP com nexcmp backup e restaure-o no mesmo servidor ou em um novo.
url: https://nexcmp.com/pt/docs/getting-started/backup-and-restore/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Backup and restore {#backup-and-restore}

> **Onde fica no painel:** System › Admin › Backup (`/backup`) aparece apenas quando o módulo DDoS & BGP está ativado; para uma instalação padrão, use a linha de comando abaixo.

## O que é incluído no backup {#what-is-backed-up}

`sudo nexcmp backup` cria um arquivo compactado contendo:

| Parte | Conteúdo |
|---|---|
| `data/**/*.db` | Todos os bancos de dados SQLite em `/var/lib/nexcmp`, copiados com a API de backup online do SQLite — consistente mesmo com o painel em execução |
| `files.tar` | Todos os outros arquivos em `/var/lib/nexcmp` (arquivos de configuração, uploads de marca, `secrets/`), exceto bancos de dados e a pasta `updates/` |
| `etc/` | Uma cópia de `/etc/nexcmp` (configurações do instalador, ID da instância, porta e bind) |

::: warning O arquivo compactado contém suas chaves mestras
`secrets/` armazena a chave que criptografa chaves de API, credenciais de pagamento e senhas SMTP armazenadas no banco de dados. O arquivo é criado com permissões `0600`. Armazene-o criptografado e fora do servidor. Sem essas chaves, um banco de dados restaurado não poderá descriptografar seus segredos.
:::

## Criar um backup {#take-a-backup}

```bash
sudo nexcmp backup                 # writes to /var/backups/nexcmp
sudo nexcmp backup /mnt/nas/nexcmp # or to another directory
```

O comando exibe o caminho do arquivo, por exemplo `/var/backups/nexcmp/nexcmp-backup-20261030-120000.tar.zst`.

### Agende o backup {#schedule-it}

```bash
echo '17 3 * * * root /usr/local/bin/nexcmp backup /var/backups/nexcmp && find /var/backups/nexcmp -name "nexcmp-backup-*" -mtime +14 -delete' | sudo tee /etc/cron.d/nexcmp-backup
```

Copie a pasta para fora da máquina (armazenamento de objetos, NAS, outro servidor).

## Restauração {#restore}

Restaure em um servidor onde o NexCMP da **mesma versão (ou mais recente)** esteja instalado.

1. Instale o NexCMP com o [instalador](https://nexcmp.com/pt/docs/getting-started/installation/) usando a mesma licença e domínio, mas **não** execute o assistente de configuração.
2. Pare os serviços:
   ```bash
   sudo systemctl stop nexcmp-vmd nexcmp
   ```
3. Descompacte o arquivo em um diretório temporário:
   ```bash
   sudo mkdir /root/restore && sudo tar --zstd -xf nexcmp-backup-20261030-120000.tar.zst -C /root/restore
   ```
4. Restaure os arquivos:
   ```bash
   sudo tar -xf /root/restore/files.tar -C /var/lib/nexcmp
   sudo cp -a /root/restore/data/. /var/lib/nexcmp/
   sudo cp -a /root/restore/etc/. /etc/nexcmp/
   sudo chown -R nexcmp:nexcmp /var/lib/nexcmp
   ```
5. Inicie os serviços e verifique:
   ```bash
   sudo systemctl start nexcmp nexcmp-vmd
   sudo nexcmp status
   ```
6. Entre em `https://<domain>/admin` com o administrador do sistema *do qual foi feito o backup*.

::: tip Faça um ensaio
Execute os passos 1 a 6 em um servidor reserva uma vez, antes de precisar. Um backup que você nunca restaurou é apenas uma esperança.
:::

## Não incluído {#not-included}

- Configuração do nginx e certificados (regenerados pelo instalador; os certificados Let's Encrypt são reemitidos).
- Seus servidores CloudStack / Proxmox VE e as máquinas virtuais neles — faça o backup deles com suas próprias ferramentas.