Documentação · Começando
Primeira VM
Crie a VM, instale o macOS e use-a no dia a dia.
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:
- Número da VM, de 10 a 99. O padrão é o primeiro número livre.
- Instalador do macOS:
1Recovery: baixado dos servidores da Apple; a instalação do macOS usa a internet;2Full: uma imagem de instalador completo que você já tem, sem baixar o macOS.
- 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.
- Tamanho do disco do macOS, como
256Gou1T. 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
8Gou16G(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.
- No menu do OpenCore, escolha o instalador. Com uma imagem completa, a opção é Install macOS seguida do nome da versão.
- No instalador, abra o Utilitário de Disco e apague o disco REIMS macOS no formato APFS.
- 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,FeT, 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 6Todas as opções estão em Comandos.