Pular para o conteúdo
Documentação: Primeira VM

Documentação · Começando

Primeira VM

Crie a VM, instale o macOS e use-a no dia a dia.

Alfa

Esta documentação corresponde ao OSX-REIMS 0.3.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.

Com o computador preparado pelo osx-reims setup (veja Instalação), criar uma VM leva poucas perguntas. Se você já tem um macOS instalado em outra VM, veja Importar uma VM.

Criar a VM

Abra o console e escolha Create new VM. O OSX-REIMS mostra as VMs existentes e pergunta:

  1. Número da VM, de 10 a 99. O padrão é o primeiro número livre.
  2. Instalador do macOS:
    • 1 Recovery: baixado dos servidores da Apple; a instalação do macOS usa a internet;
    • 2 Full: uma imagem de instalador completo que você já tem, sem baixar o macOS.
  3. Versão do macOS: Ventura (13), Sonoma (14), Sequoia (15) ou Tahoe (26). O padrão é o Ventura, e as versões com o Recovery já baixado aparecem marcadas. Com uma imagem completa, a versão vem da própria imagem.
  4. Tamanho do disco do macOS, como 256G ou 1T. O padrão é 256G; o disco só ocupa espaço conforme é preenchido.

Depois do resumo, confirme Create the VM?. O OSX-REIMS então:

  • baixa o Recovery da Apple, o que pode levar alguns minutos, ou reaproveita um já baixado;
  • gera a identidade da VM e o disco de inicialização com o OpenCore;
  • cria a VM, com o disco do macOS e uma cópia do instalador.

No fim, o console oferece iniciar a VM na hora: pressione S.

Imagem de instalador completo

A imagem precisa ser um disco criado com o createinstallmedia, com o volume "Install macOS" e o nome da versão, normalmente em .iso, .img ou .cdr. Não servem o app do instalador, imagens de CD/DVD (ISO 9660), DMGs compactados nem imagens qcow2 ou vmdk.

Coloque as imagens em /opt/osx-reims/full/ para o menu oferecê-las; também dá para digitar o caminho de outro arquivo. Quando o sistema de arquivos permite, a VM recebe um clone da imagem que não ocupa espaço; senão, uma cópia.

Instalar o macOS

Inicie a VM pelo console, logo depois de criá-la ou em Manage VMs, ou com osx-reims start <número>. O OSX-REIMS pergunta:

  • Memória, como 8G ou 16G (padrão: 8G);
  • Processadores, de 1 a 32 (padrão: 4).

O resumo mostra o modo macOS installation. Confirme Start the VM?. Na primeira inicialização, o instalador é conectado à VM automaticamente, e a VM abre na própria janela.

  1. No menu do OpenCore, escolha o instalador. Com uma imagem completa, a opção é Install macOS seguida do nome da versão.
  2. No instalador, abra o Utilitário de Disco e apague o disco REIMS macOS no formato APFS.
  3. Volte e instale o macOS nesse disco. A VM pode reiniciar algumas vezes durante a instalação.

Dica

Memória e processadores são perguntados a cada inicialização. Os valores sugeridos não são requisitos mínimos: escolha de acordo com o seu computador.

Usar a VM no dia a dia

Depois da primeira inicialização, a VM aparece como Installed. Ao iniciá-la, além da memória e dos processadores, o OSX-REIMS pergunta qual OpenCore usar:

Tecla Opção
I VM boot disk: o OpenCore que veio com a VM (recomendado)
D macOS disk: o OpenCore instalado na EFI do próprio disco do macOS

Mantenha VM boot disk, a menos que você mesmo tenha instalado o OpenCore na EFI do disco do macOS. Mais detalhes em Configuração avançada.

Com a VM aberta:

  • desligue pelo menu Apple › Desligar, dentro do macOS;
  • mantenha o terminal aberto enquanto usa a VM; fechá-lo não desliga a VM;
  • no terminal, as teclas S, R, F e T, pressionadas duas vezes, desligam, reiniciam, forçam o desligamento ou encerram a VM (veja Console).

O resumo da inicialização também mostra a porta SSH da VM, localhost:22 seguido do número da VM (por exemplo, localhost:2210 para a VM 10). Para usá-la, ative o Login Remoto no macOS.

Estados das VMs

Estado Significado
Ready to install Criada com instalador; a próxima inicialização abre a instalação do macOS
Ready for first use Importada, ou criada sem instalador; ainda não foi iniciada
Installed Já passou pela primeira inicialização e inicia pelo próprio disco
Starting Iniciando
Running Em execução
Faulty (incomplete disk) O disco da VM está incompleto; compartilhe o log ao pedir ajuda
Faulty (no base disk) Falta o disco base da VM; compartilhe o log ao pedir ajuda

Pelo terminal

Os mesmos passos, sem o menu:

osx-reims create -i 11 -m sonoma -s 256G -y
osx-reims start 11 -r 16G -c 6

Todas as opções estão em Comandos.