Documentação · Começando
Requisitos
O que o computador precisa ter para rodar o OSX-REIMS e as versões do macOS oferecidas.
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.
Computador
| Item | Requisito |
|---|---|
| Sistema | Ubuntu Desktop 26.04 LTS, 64 bits (x86_64) |
| Processador | Intel ou AMD de 64 bits, com virtualização de hardware (Intel VT-x ou AMD-V) habilitada no BIOS/UEFI |
| GPU | Suporte a Vulkan 1.2 ou superior (Intel, AMD ou NVIDIA), com o driver instalado; em placas NVIDIA, o driver completo da NVIDIA (veja abaixo) |
| VMs dentro do macOS (opcional) | Processador Intel, com a virtualização aninhada ligada no KVM (kvm_intel nested=Y, o padrão do Ubuntu) |
| Armazenamento | Pelo menos 14 GB livres: 10 GB para o Reims vGPU, em /opt, e 4 GB para o Rust, na sua pasta pessoal, além do espaço das VMs (dezenas de GB cada) |
| Internet | Necessária para preparar o computador, baixar o Recovery da Apple e, na primeira VM, os componentes da EFI |
| Rede em ponte (opcional) | Uma porta de rede com cabo, gerenciada pelo NetworkManager (o padrão do Ubuntu Desktop); o Wi-Fi não serve |
Em um sistema diferente do Ubuntu 26.04, o setup avisa que ele não foi testado e pergunta se deve continuar. Com -y, ele para.
Memória e processadores das VMs
A memória e os processadores são escolhidos na primeira inicialização de cada VM e ficam salvos nela, então as inicializações seguintes não perguntam de novo. Os valores sugeridos (8 GB e 4 processadores) não são requisitos mínimos do computador. Veja Configurações da VM.
Em um computador com mais de uma GPU, cada VM pode rodar na GPU escolhida para ela; sem escolha, a VM roda na GPU dedicada.
GPU e driver
O Reims vGPU precisa que o driver Vulkan da GPU ofereça a extensão VK_EXT_external_memory_host. Os drivers da Intel, da AMD e o driver completo da NVIDIA oferecem; o driver aberto nouveau (NVK) não. Uma GPU sem ela não aparece entre as GPUs que uma VM pode usar, e o osx-reims doctor avisa.
- NVIDIA. Instale o driver completo da NVIDIA, por exemplo com
sudo ubuntu-drivers install, e reinicie o computador. Ele traz a bibliotecalibcuda.so.1, de que o Vulkan da NVIDIA precisa para o Reims vGPU. - AMD. A memória da VM chega à GPU pelo
/dev/udmabuf, liberado pelosetupao adicionar o seu usuário ao grupokvm. O Mesa do Ubuntu 26.04 já tem o que o Reims vGPU precisa; com um Mesa mais antigo, odoctoravisa (Large GPU buffers). - Intel. Nada além do driver do próprio Ubuntu.
Espaço em disco
- Na primeira preparação, o
setupconfere se há espaço livre para o Reims vGPU, em/opt/reims-vgpu(10 GB), e para o Rust, na sua pasta pessoal (4 GB). - Cada VM macOS ocupa dezenas de GB. O disco da VM só ocupa espaço conforme é preenchido, até o tamanho escolhido na criação.
- O
doctoravisa quando a pasta das VMs tem menos de 40 GB livres. - Importar uma VM copia os dados do disco para a pasta das VMs: é preciso ter esse espaço livre, mais uma pequena margem.
- Cada backup de uma VM ocupa quase o tamanho dos dados dela, em
/opt/osx-reims/backup: o disco do macOS se comprime pouco.
Versões do macOS
| Versão | Observação |
|---|---|
| macOS Ventura (13) | Padrão na criação de VMs e versão recomendada pelo projeto Reims vGPU |
| macOS Sonoma (14) | Oferecida na criação de VMs |
| macOS Sequoia (15) | Oferecida na criação de VMs |
| macOS Tahoe (26) | Oferecida na criação de VMs |
Oferecer uma versão não significa compatibilidade garantida: o resultado depende do computador, da GPU e dos drivers.
Como conferir antes de instalar
Para ver se a virtualização está habilitada, rode o comando abaixo. A linha Virtualization (ou Virtualização) deve mostrar VT-x ou AMD-V:
lscpu | grep -i virtualizaPara ver se o KVM está disponível, confira se o arquivo /dev/kvm existe:
ls -l /dev/kvmDepois de instalar o OSX-REIMS, o osx-reims doctor confere tudo isso e mais: GPU com Vulkan, grupos do usuário, configuração do KVM, o som, a rede das VMs e o Reims vGPU. Veja Solução de problemas.
Acesso
O OSX-REIMS é exclusivo para membros com assinatura ativa nos níveis Hackintosh - Avançado e Hackintosh - vGPU OS do Universo Hackintosh. Veja Licença.