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

Documentação · Começando

Primeira VM

Crie a VM, instale o macOS e aprenda a operá-la.

Alfa

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:

  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>. Na primeira inicialização, o OSX-REIMS pergunta as configurações da VM:

  • Memória, como 8G ou 16G (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.

  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

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, F e T, 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 --fullscreen

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