Backup e restauração
Proteja a instância, bancos e volumes de aplicações.
Há dois tipos de backup, e você precisa dos dois:
- Backup da instância: o próprio Pier. Guarda contas, projetos, configurações, senhas cifradas e a chave que abre essas senhas.
- Backup dos dados: o que as suas aplicações guardam, como bancos e volumes.
Backup da instância
Em Configurações › Backups, seção Backup da instância:
- Baixar backup criptografado: gera um arquivo
.pierbak. Você escolhe uma frase-senha de pelo menos 16 caracteres. - Backup automático local: escolha a pasta de destino no servidor, um horário em cron (por exemplo
0 2 * * *) e quantos backups manter.
O arquivo contém uma cópia consistente do banco do Pier (pier.db) e a chave das credenciais. Ele é cifrado com AES-256-GCM, com chave derivada da frase-senha.
Guarde a frase-senha fora do servidor, num gerenciador de senhas. Sem ela, o backup não abre. E copie os arquivos
.pierbakpara outra máquina: um backup no mesmo disco some junto com ele.
Pela CLI, o mesmo backup:
pierctl instance backup --out pier-$(date +%F).pierbak --passphrase-file ./frase-senha.txt
pierctl instance status # quando foi o último backupAté o primeiro backup existir, o painel mostra um aviso no topo.
O que não entra
O backup da instância não inclui:
- os dados dos bancos, que têm backup próprio, descrito abaixo;
- os volumes das aplicações e das stacks;
- os certificados emitidos, que são pedidos de novo quando faltam.
Restaurar a instância
A restauração é feita com o Pier parado, para não haver duas cópias escrevendo no mesmo banco. No servidor, na pasta pier:
Pare o painel:
shdocker compose stop pierColoque o arquivo e a frase-senha numa pasta, por exemplo
/root/restauracao. A frase-senha vai num arquivo de texto:shsudo install -d -m 700 /root/restauracao sudo cp pier-2026-11-11.pierbak /root/restauracao/instancia.pierbak # Crie /root/restauracao/frase com um editor seguro; não exponha a frase no histórico. sudo chmod 600 /root/restauracao/fraseRode a restauração com a mesma imagem do Pier. O comando usa o diretório de dados do
.env:sh. ./.env docker compose run --rm --no-deps \ -v /root/restauracao:/restauracao:ro \ pier restore --file /restauracao/instancia.pierbak \ --passphrase-file /restauracao/frase --data-dir "$PIER_DATA_DIR"Suba o painel e entre com a sua conta de sempre:
shdocker compose up -d pier
Antes de trocar qualquer arquivo, o comando confere a frase-senha, a autenticidade do arquivo e a integridade do banco. Os arquivos antigos não são apagados: recebem o sufixo .before-restore-…. Guarde-os até confirmar que está tudo certo, e depois apague a pasta /root/restauracao.
Se o painel ainda estiver rodando, a restauração é recusada.
Se você define
PIER_SECRET_KEYno.env, ela precisa ser exatamente a da instância que gerou o backup. SemPIER_SECRET_KEY, vale a chave que veio no backup.
Mudar de servidor
Para levar o Pier para outra máquina:
- Instale o Pier no servidor novo, sem criar conta.
- Restaure o backup como acima.
- Aponte o DNS para o novo IP.
As aplicações precisam ser implantadas de novo no servidor novo. Os dados dos bancos voltam pelos backups deles.
Backup dos bancos
Cada banco PostgreSQL, MySQL, MariaDB ou MongoDB tem backup agendado, cópia para S3, teste de restauração semanal e restauração com um clique. Veja Bancos de dados.
Volumes das aplicações
Na aplicação ou stack, abra Backups de volumes. Os volumes aparecem após o primeiro deploy. Configure agenda, retenção, cópia S3 e quais diretórios devem entrar. Por padrão, diretórios externos ao caminho de dados do Pier ficam de fora; caminhos de sistema continuam proibidos.
Use Parar os containers durante o backup quando precisar de dados consistentes: a aplicação fica indisponível enquanto o arquivo é gerado, inclusive nas execuções agendadas. Sem essa opção, um arquivo pode mudar durante a cópia. Para bancos ativos, prefira o backup lógico do banco.
O backup é um .tar.gz dos volumes/diretórios selecionados; não é o backup cifrado da instância. Proteja o arquivo e o destino externo. Para restaurar, escolha um backup concluído e digite o nome exato do recurso. A restauração interrompe o recurso, substitui o conteúdo dos volumes e inicia os containers ao final. Ela não mescla arquivos nem é uma migração automática para outro servidor. Teste em dados descartáveis antes de restaurar produção.
Acompanhe a operação até concluir e confira os arquivos da aplicação. Backup no mesmo disco não protege contra perda do servidor.
Redis, KeyDB e Dragonfly
Esses bancos têm backup de snapshot RDB no mesmo fluxo de retenção, download e cópia S3. A restauração é no próprio banco, com substituição do conjunto de dados e indisponibilidade. Ela remove arquivos de persistência anteriores que poderiam prevalecer sobre o snapshot. Não trate o arquivo como restauração universal entre versões ou engines. ClickHouse não ganha restauração por esse fluxo.
Uma rotina que funciona
- Backup da instância agendado todo dia, com cópia diária para fora do servidor.
- Backup de cada banco agendado, com cópia para S3 e teste de restauração ligado.
- Alertas de "backup não executado" chegando num canal que você lê.
- Uma vez por trimestre, restaure de verdade num servidor de teste.