Documentação · Uso
Configurações da VM
Memória, processadores, tela, servidor gráfico, OpenCore, GPU, taxa de atualização, rede, som e início automático: o que cada VM guarda e como mudar.
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.
Cada VM guarda as próprias configurações, na pasta dela. Você responde uma vez e, dali em diante, iniciar a VM é uma tecla: o osx-reims start mostra o resumo do que ela vai usar e pergunta apenas se deve iniciar.
O menu de início
Com todas as configurações da VM salvas, o start mostra o resumo e oferece:
| 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 |
C abre a lista de configurações, cada uma com o valor atual. Escolher uma leva à mesma pergunta que a primeira inicialização fez; ao voltar, o resumo aparece de novo — então o que o resumo mostra é sempre o que a VM vai usar.
A primeira inicialização de uma VM pergunta tudo o que pode: memória, processadores, tela e servidor gráfico. As respostas ficam salvas e viram o padrão daquela VM.
Nota
Uma configuração respondida no menu C é salva na hora. Mudar uma configuração e depois cancelar o início deixa o novo valor para a próxima vez; Q significa apenas "não iniciar agora".
O que cada VM guarda
| Configuração | Tecla em C |
Valores | Opção na linha de comando |
|---|---|---|---|
| Memória | M |
8G, 16384M… (padrão: 8G) |
-r, --ram |
| Processadores | P |
de 1 a 32 (padrão: 4) |
-c, --cpus |
| OpenCore | O |
disco de inicialização da VM ou disco do macOS | --opencore image|esp |
| Tela | S |
janela (padrão) ou tela cheia | --windowed, --fullscreen |
| Servidor gráfico | D |
wayland ou x11 |
--wayland, --x11 |
| VMs dentro do macOS | V |
desligado (padrão) ou ligado | --nested, --no-nested |
| GPU | U |
automática (padrão) ou uma GPU do computador | --gpu auto|<fabricante:dispositivo> |
| Taxa de atualização | R |
automática (padrão) ou uma taxa em Hz | --refresh auto|<Hz> |
| Rede | N |
NAT (padrão) ou ponte | --net nat|bridge |
| Som | H |
ligado (padrão) ou desligado | --audio, --no-audio |
| Início automático | A |
desligado (padrão) ou ligado para uma VM | osx-reims autostart |
Em uma VM instalada que ainda tem o instalador com que foi criada, o menu C também oferece I (Installer), para conectá-lo de novo em uma única inicialização (veja Instalador de novo).
- OpenCore só aparece para uma VM já instalada, porque uma VM só fica instalada depois da própria primeira inicialização. Sem resposta, ela inicia pelo próprio disco de inicialização, e o resumo diz isso.
- VMs dentro do macOS, GPU, taxa de atualização, rede e som não são perguntados na primeira inicialização: ficam no valor padrão até você mudá-los no menu
Cou por uma opção da linha de comando. - Início automático não fica na pasta da VM: é um serviço deste computador (veja Início automático).
- Uma opção da linha de comando vale para aquela inicialização e vira o valor salvo da VM.
- Um valor salvo que não passa mais nas verificações — mais processadores do que o limite, depois de copiar a pasta da VM para outro computador — conta como ausente, e aquela inicialização pergunta de novo.
Os arquivos ficam na pasta da VM, em /opt/reims-vgpu/vm/disks/rails/macos-<número>/: RAM, CPUS, SCREEN, BACKEND, NESTED, GPU, REFRESH, NET, AUDIO e, dentro de live/, OPENCORE. Um arquivo GUEST_IMPORT deixado pela versão 0.4 (a antiga configuração de memória da GPU) é ignorado.
Tela: janela ou tela cheia
Em tela cheia, a VM ocupa o monitor inteiro, sem decoração de janela e sem a área de trabalho do Ubuntu atrás dela. A pergunta é feita para toda VM, instalada ou não, porque a tela cheia é útil também durante a instalação do macOS.
- Nada muda dentro do macOS: ele mantém a própria resolução, 1920 × 1080, e a imagem é ajustada ao monitor e centralizada, então um monitor com outra proporção mostra tarjas pretas.
- Para voltar ao terminal, devolva o teclado ao Ubuntu com
Ctrl+Alt+Supere useAlt+Tab. - A VM abre no monitor em que a janela aparece; a escolha do monitor não é do OSX-REIMS.
Servidor gráfico: Wayland ou X11
A janela da VM pode abrir no Wayland da própria sessão ou no X11, pelo XWayland. O padrão é o servidor que a sua sessão usa: um ambiente sem Wayland (o Cinnamon, o MATE e o Xfce do Linux Mint, e qualquer outra sessão X11) recebe x11 como padrão. Os dois são sempre listados, e o que a sessão não tem aparece marcado.
A janela é a do próprio Reims vGPU. Clique nela para o macOS receber o teclado: os atalhos que a área de trabalho guarda para si (Cmd, Alt+Tab, as combinações com Super) passam a ir para o macOS. Ctrl+Alt+Super, pressionadas juntas, devolvem o teclado ao Ubuntu, e a janela também o devolve quando perde o foco; o título da janela diz em que estado ela está.
Onde o ambiente tem os dois servidores, a diferença é como a captura do teclado é concedida:
- no Wayland, o GNOME confirma o pedido com uma janela toda vez que a VM recebe o teclado, porque a janela não tem como ser associada a um aplicativo instalado e a resposta não é guardada;
- no X11, o mesmo pedido é atendido sem pergunta.
Atenção
Fechar a janela da VM a desliga na hora, como tirar da tomada. Desligue o macOS pelo menu Apple, ou com osx-reims stop.
Nota
Pedir um servidor que a sessão não tem é recusado no início da VM: uma janela em um servidor que não existe não abriria em lugar nenhum.
VMs dentro do macOS
Com VMs dentro do macOS ligado, o processador que o macOS vê passa a ter o Intel VT-x, então o Hypervisor.framework funciona dentro da VM e o Docker, o VirtualBox e o emulador do Android têm em que rodar. Dentro do macOS, sysctl kern.hv_support responde 1 quando está valendo.
- Nada mais muda no macOS: a identidade que ele mostra é a mesma, então ligar e desligar não afeta os serviços da Apple.
- A VM precisa ser reiniciada para a mudança chegar até ela.
- Precisa de um computador Intel com a virtualização aninhada ligada no KVM (
kvm_intel nested=Y, o padrão do Ubuntu). Não é uma questão de desempenho no AMD: o macOS virtualiza só pelo VT-x, e o KVM não tem como oferecê-lo em um processador AMD. - Onde o computador não pode oferecer isso, a resposta da VM continua salva, a VM inicia sem o recurso, e o menu, o resumo e o
osx-reims doctordizem isso.
GPU
Em um computador com mais de uma GPU — uma integrada e uma placa de vídeo —, a VM roda na GPU que o Reims vGPU escolhe: a dedicada. Essa é a resposta automática. Cada VM pode indicar outra:
osx-reims start 10 --gpu 8086:a780 # esta VM na GPU integrada Intel
osx-reims start 10 --gpu auto # de volta à escolha do Reims vGPUO menu C › U lista as GPUs que o Vulkan mostra neste computador e que o Reims vGPU pode usar (Vulkan 1.2 ou superior, com a extensão VK_EXT_external_memory_host), cada uma pelo identificador de fabricante e dispositivo (1002:73ff), como o vulkaninfo --summary mostra. Uma GPU que não está no computador na hora de iniciar — uma pasta de VM trazida de outro computador, ou uma GPU integrada que a placa-mãe desliga — não impede o início: a VM inicia na GPU automática, o resumo diz isso, e a escolha continua salva para quando aquela GPU voltar.
Uma GPU cujo driver não tem VK_EXT_external_memory_host, como a NVIDIA com o driver aberto nouveau (NVK), não roda VMs: ela não é oferecida no menu, e quando a escolha automática cairia nela, o start usa a melhor GPU que tem a extensão e diz qual deixou de lado e por quê. Sem nenhuma GPU assim, o start recusa e diz o que instalar. Veja Requisitos.
O resumo da inicialização tem uma linha GPU, com a GPU em que a VM roda; o osx-reims doctor mostra a resposta automática deste computador e as VMs com escolha própria.
Nota
Até a versão 0.4.1, cada VM tinha a configuração memória da GPU (--guest-import). O Reims vGPU reescrito não tem mais essa escolha: ele sempre entrega a memória da VM à GPU, pelo /dev/udmabuf onde o driver precisa. A configuração deixou de existir.
Taxa de atualização
O macOS desenha a área de trabalho na taxa de atualização que o Reims vGPU oferece. No automático, o padrão, é a taxa do monitor em que a janela da VM abre: em um monitor a 120 Hz, o macOS roda a 120 Hz (Ajustes do Sistema › Telas mostra). Cada VM pode ter uma taxa própria, no menu C › R (60, 75, 100, 120, 144, 165 ou 240 Hz) ou com --refresh:
osx-reims start 10 --refresh 120 # o macOS a 120 Hz, qualquer que seja a do monitor
osx-reims start 10 --refresh auto # de volta à taxa do monitorUma taxa acima da do monitor só gasta GPU: o macOS desenha mais quadros do que a janela mostra. Uma abaixo economiza um pouco. A VM lê a taxa ao iniciar, então a mudança vale na próxima inicialização. O resumo tem uma linha Refresh.
Rede: NAT ou ponte
Cada VM fica em NAT, o padrão, ou na ponte (bridge), no menu C › N ou com --net:
osx-reims start 10 --net bridge # endereço próprio na rede deste computador
osx-reims start 10 --net nat # de volta ao endereço deste computador- NAT: a VM acessa a rede e a internet pelo endereço deste computador e só é acessada por ele; o SSH dela fica em
localhost:22<número>. Não há nada a preparar. - Ponte: a VM entra na rede em que este computador está ligado por cabo, com um endereço próprio dado pelo mesmo roteador, e é acessada por qualquer computador dessa rede. Este computador mantém o próprio endereço.
A ponte é preparada uma vez, no console (Maintenance › VM network) ou pelo terminal:
osx-reims network # a ponte, as VMs nela e as portas com cabo
osx-reims network bridge on # na porta da rota padrão
osx-reims network bridge on --port enp6s0
osx-reims network bridge off # recusado com uma VM na ponte ligada- Precisa de uma porta de rede com cabo: o Wi-Fi não pode ser usado em ponte.
- A porta precisa ser gerenciada pelo NetworkManager, como no Ubuntu Desktop. Em outro caso, nada é mudado e a ponte precisa ser feita à mão.
- Ligar e desligar a ponte pede a senha de administrador. A rede para por alguns segundos enquanto a ponte é montada; se o computador não recuperar o endereço em um minuto, a mudança é desfeita sozinha.
- Depois disso, a ponte sobe junto com o computador, com 8 portas para VMs: até 8 VMs podem estar na ponte ao mesmo tempo. Iniciar ou desligar uma VM nunca mexe na rede deste computador.
- Uma VM configurada para a ponte não inicia enquanto a ponte não existe: ela não é movida para o NAT sozinha. O resumo diz isso, e
C›Na coloca em NAT.
O osx-reims doctor tem uma linha VM network. Remover o pacote do OSX-REIMS não desfaz a ponte: rode osx-reims network bridge off antes.
Som
Cada VM tem som, a menos que você o desligue, no menu C › H ou com --audio e --no-audio:
osx-reims start 10 --no-audio # nenhum dispositivo de som na VM
osx-reims start 10 --audio # o som de voltaCom o som ligado, a VM recebe dois dispositivos, os dois tocando pelo servidor de som da sessão (o PipeWire do Ubuntu, ou o PulseAudio):
- um dispositivo de áudio USB, que o macOS usa do Ventura ao Tahoe sem instalar driver: é o som do macOS, listado em Ajustes do Sistema › Som;
- um controlador HD Audio, para o som de inicialização do OpenCore. Ele está na EFI das VMs criadas a partir da 0.6.0; as VMs que já existiam mantêm o próprio OpenCore, então recebem o som do macOS, mas não o do OpenCore.
As caixas de som usadas são as que o Ubuntu escolhe nas configurações de som dele. Sem servidor de som, a VM inicia em silêncio, e o resumo diz isso. A mudança vale na próxima inicialização. O resumo tem uma linha Audio, e o doctor, uma linha Sound.
Instalador de novo
Uma VM nova recebe o instalador só na primeira inicialização; dali em diante, ela inicia pelo próprio disco. Se a instalação do macOS foi interrompida no meio, ou se você quer reinstalar ou reparar o macOS, o instalador pode ser conectado de novo em uma inicialização, sem apagar nem recriar nada:
osx-reims start 10 --attach-installerNo menu C, é a opção I (Installer), oferecida para uma VM instalada que ainda tem o instalador. O disco da VM fica como está — o Utilitário de Disco do instalador pode apagá-lo, se for o caso — e nada é salvo: a próxima inicialização é sem o instalador. Uma VM importada não tem instalador.
OpenCore
O OpenCore que inicia a VM pode ser o disco de inicialização da VM, que veio com ela, ou o disco do macOS, quer dizer, o OpenCore na partição EFI do próprio disco onde o macOS está instalado. Os detalhes, inclusive como instalar o OpenCore da VM nessa EFI, estão em Configuração avançada.
Início automático
O início automático faz uma VM abrir sozinha, para que ligar o computador termine no macOS. Ele fica no menu C › A e também tem comando próprio:
osx-reims autostart status
osx-reims autostart on 13 # e oferece o login automático do Ubuntu
osx-reims autostart on 13 --login # sem perguntar
osx-reims autostart offComo a janela da VM abre na sessão gráfica, nada inicia a VM antes de alguém entrar na sessão: é um serviço de usuário do systemd (osx-reims-vm@<número>.service), não um serviço do sistema. Por isso, ir de "ligar o computador" até o macOS são duas configurações:
- o início automático da VM;
- o login automático do Ubuntu, que é uma configuração do próprio Ubuntu (
/etc/gdm3/custom.conf). O OSX-REIMS oferece ligá-lo quando o início automático é ativado, e nunca o liga como efeito colateral.
Atenção
Com o login automático, quem liga o computador entra na sua sessão, e a senha de login deixa de destravar o chaveiro. Na primeira mudança, uma cópia do arquivo é guardada em /etc/gdm3/custom.conf.osx-reims.bak.
- Só uma VM pode ter o início automático; ativá-lo em uma tira-o da outra.
- Só uma VM com o macOS já instalado pode tê-lo: a primeira inicialização é a instalação do macOS, que não é para ficar sozinha na tela.
- A VM inicia com as próprias configurações salvas. Para o monitor inteiro, deixe a Tela dela em tela cheia.
- Desligar o macOS encerra o serviço, e é assim que você volta ao Ubuntu. Sair da sessão ou desligar o computador pede o desligamento ao macOS e espera até 120 segundos, em vez de cortar a energia.
- Se a VM não iniciar, uma notificação e uma janela de terminal dizem o motivo e abrem o console — o erro não fica escondido no log do sistema.
- A resposta fica no systemd, e não na pasta da VM: copiar a pasta para outro computador não leva o início automático com ela.
Configurações fixas do computador
Em um computador que sempre mostra a VM do mesmo jeito, como um totem, o arquivo /etc/osx-reims.conf aceita FORCE_SCREEN e FORCE_BACKEND. Eles vêm antes da escolha salva de cada VM e depois da resposta daquela inicialização, então as opções da linha de comando e o menu C continuam valendo. Veja Configuração avançada.
Tudo pela linha de comando
osx-reims start 13 -r 16G -c 6 --fullscreen --x11 --nested
osx-reims start 13 --refresh 120 --net bridge --no-audio
osx-reims start 13 -y # sem perguntas, com o que estiver salvo
osx-reims start 13 --dry-run # mostra o comando de inicialização e saiTodas as opções estão em Comandos.