Documentação · Uso
Backup e restauração
Guarde uma VM inteira em um único arquivo e coloque-a de volta, por cima dela mesma ou como uma nova VM.
Esta documentação corresponde ao OSX-REIMS 0.6.0, em estágio alfa. Comandos e opções podem mudar entre versões; na dúvida, confira osx-reims --help na versão instalada.
Uma VM inteira pode virar um único arquivo de backup e ser colocada de volta depois: por cima dela mesma, para desfazer um erro ou uma atualização que deu errado, ou como uma nova VM.
O que entra no backup
A pasta inteira da VM, macos-<número>:
- o disco do macOS;
- o disco de inicialização com o OpenCore;
- as configurações do firmware;
- a identidade da VM (número de série, MLB, UUID, ROM e endereço MAC) e todas as configurações dela.
Os instaladores (o Recovery, ou a cópia de uma imagem de instalador completo) ficam de fora, porque uma VM instalada não volta a usá-los e eles podem ter vários GB. Para incluí-los, use --with-installers. Uma VM restaurada sem eles não reinstala o macOS a partir de si mesma: para isso, crie uma VM nova. Uma VM com o macOS ainda não instalado sempre leva os instaladores.
Fazer o backup
No console, escolha Backup & Restore (tecla 6) › Back up a VM, ou rode:
osx-reims backup 10A VM precisa estar desligada enquanto é copiada. Se ela estiver ligada, o OSX-REIMS pergunta se pode desligá-la antes — o macOS recebe o pedido de desligar, como em Shut down. Se em um minuto ele não desligar (uma confirmação na janela da VM, um app impedindo, ou o assistente de configuração, que ignora o pedido), o console oferece esperar mais, forçar o desligamento ou cancelar.
O arquivo fica em /opt/osx-reims/backup, com o nome macos-<número>-AAAAMMDD-HHMMSS.osxreims.tar.zst. Ele é compactado com o zstd, mas um disco de macOS se comprime pouco, porque o próprio macOS já comprime os arquivos dele: conte com um arquivo quase do tamanho dos dados da VM. Como exemplo, uma VM com Ventura com 26,7 GB de dados virou um arquivo de 21,7 GB em 32 segundos.
- O arquivo só pode ser lido pelo seu usuário, porque leva a identidade da VM.
- Enquanto está sendo gravado, ele tem um nome oculto, terminado em
.partial, e só ganha o nome final quando está completo. Um arquivo deixado por um backup interrompido é apagado no próximo.
Restaurar
No console, escolha Backup & Restore › Restore a backup, ou rode osx-reims restore, que lista os backups, do mais novo para o mais antigo. Quando a VM de origem ainda existe, o OSX-REIMS pergunta como restaurar:
| Opção | O que faz |
|---|---|
Replace it (--replace) |
A VM volta a ser o que era no backup; o que mudou desde então se perde. Ela precisa estar desligada |
As a new VM (--as <n>) |
Restaura com outro número, com um novo endereço MAC e o resto da identidade mantido, então o macOS e os serviços da Apple continuam vendo o mesmo Mac |
Quando a VM de origem não existe mais, o backup volta com o próprio número, como era.
osx-reims restore macos-10-20261017-153000.osxreims.tar.zst --replace
osx-reims restore macos-10-20261017-153000.osxreims.tar.zst --as 12A VM é descompactada em uma pasta oculta ao lado das outras e só toma o lugar quando está completa e conferida; ao substituir, a VM antiga só sai do lugar nesse momento. Então uma restauração que falha, um arquivo danificado ou um cancelamento deixam todas as VMs como estavam.
- Um backup feito por uma versão do OSX-REIMS mais nova do que a instalada é recusado.
- Uma VM que abria com o computador (início automático) recebe a oferta de voltar a fazer isso.
Listar e apagar
osx-reims backup --list
osx-reims backup --delete macos-10-20261017-153000.osxreims.tar.zstNo console, apagar fica em Backup & Restore › Delete a backup. O osx-reims doctor tem uma linha Backups, com quantos são e o espaço livre na pasta.
Onde guardar
Os backups ficam no mesmo disco das VMs, a menos que /opt/osx-reims/backup seja um ponto de montagem de outro disco. Um backup protege a VM de um erro ou de uma atualização que deu errado, não da falha do disco: copie os arquivos para outro lugar para guardá-los.
A pasta é criada pelo setup e mantida quando o pacote é removido.
Opções
| Comando | Opção | O que faz |
|---|---|---|
backup [VM] |
--with-installers |
Inclui os instaladores da VM |
backup [VM] |
--shutdown |
Com -y, desliga uma VM ligada antes; sem ela, uma VM ligada é recusada |
backup |
--list |
Lista os backups |
backup |
--delete [arquivo] |
Apaga um backup |
restore [arquivo] |
--replace |
Restaura por cima da VM de origem |
restore [arquivo] |
--as <n> |
Restaura como uma nova VM, com esse número |
restore [arquivo] |
--autostart, --no-autostart |
Se a VM restaurada abre sozinha com o computador, como a de origem (com -y, o padrão é não) |
| todos | -y, --yes |
Não faz perguntas |