Documentação · Começando
Primeira VM
Crie a VM, instale o macOS e aprenda a operá-la.
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.
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>. Na primeira inicialização, o OSX-REIMS pergunta as configurações da VM:
- Memória, como
8Gou16G(padrão:8G); - Processadores, de 1 a 32 (padrão:
4); - Tela: janela normal (padrão) ou tela cheia, ocupando o monitor inteiro;
- Servidor gráfico: o Wayland da sua sessão ou o X11 (padrão: o servidor que a sua sessão usa).
As respostas ficam salvas na VM e viram o padrão dela — nas próximas inicializações, essas perguntas não voltam. A taxa de atualização (a do monitor), a rede (NAT) e o som (ligado) não são perguntados: ficam no padrão até você mudá-los. Veja Configurações da VM.
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. Clique na janela para o macOS receber o teclado; Ctrl+Alt+Super, pressionadas juntas, devolvem o teclado ao Ubuntu.
- 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
Os valores sugeridos de memória e processadores não são requisitos mínimos: escolha de acordo com o seu computador. Em tela cheia, devolva o teclado ao Ubuntu com Ctrl+Alt+Super e use Alt+Tab para voltar ao terminal.
Nota
Se a instalação do macOS for interrompida no meio — a VM desligada ou reiniciada antes de o macOS terminar —, não é preciso apagar a VM: em C › I (Installer), ou com osx-reims start <número> --attach-installer, o instalador é conectado de novo para aquela inicialização, sem apagar o disco.
Iniciar e operar a VM
Depois da primeira inicialização, a VM aparece como Installed e já tem todas as configurações salvas. Dali em diante, o start mostra o resumo do que ela vai usar e pergunta apenas:
| Tecla | Opção |
|---|---|
S |
Start: inicia a VM com as configurações do resumo |
C |
Change: muda uma configuração antes de iniciar |
Q |
Cancel: não inicia a VM |
Em C ficam a memória, os processadores, a tela, o servidor gráfico, o OpenCore, o instalador, a GPU, a taxa de atualização, a rede, o som, as VMs dentro do macOS e o início automático com o computador. Cada uma delas está explicada em Configurações da VM.
O OpenCore é a única configuração que só aparece para uma VM instalada, e o padrão é o que veio com a VM:
| Opção | O que é |
|---|---|
| VM boot disk | O OpenCore que veio com a VM (recomendado) |
| macOS disk | O OpenCore na EFI do próprio disco do macOS, que o OSX-REIMS pode instalar para você |
Mantenha VM boot disk, a menos que você queira que o disco do macOS inicie sozinho. Mais detalhes em Configuração avançada.
Com a VM aberta:
- desligue pelo menu Apple › Desligar, dentro do macOS;
- fechar a janela da VM a desliga na hora, como tirar da tomada: prefira o menu Apple;
- 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).
Com a rede em NAT, o padrão, 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. Com a rede em ponte, a VM tem endereço próprio na rede e é acessada por ele.
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 --fullscreenTodas as opções estão em Comandos.