Pular para o conteúdo
Documentação: Visão geral

Documentação · Começando

Visão geral

O que é o OSX-REIMS, como ele funciona e onde ficam os arquivos no seu computador.

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.

O OSX-REIMS cria e gerencia máquinas virtuais macOS no Ubuntu. Ele usa o Reims vGPU (abre em nova aba), uma GPU virtual paravirtualizada para o macOS, que o QEMU apresenta à VM e que usa Vulkan para acelerar os gráficos do macOS.

Tudo fica em um único programa: um console com menus para a operação do dia a dia e comandos no terminal para cada coisa que o menu faz.

Importante

O OSX-REIMS é um projeto experimental, para estudos, experimentos e testes. Ele não substitui um computador Apple: o desempenho e a estabilidade não se comparam aos de um Mac, e recursos que dependem de hardware, serviços e integrações da Apple podem não funcionar. Não use a VM como máquina principal nem para trabalho de que você dependa. Para usar o macOS no dia a dia, com estabilidade e suporte, compre um Mac.

Nota

O OSX-REIMS é exclusivo para membros com assinatura ativa nos níveis Hackintosh - Avançado e Hackintosh - vGPU OS do Universo Hackintosh. O pacote de cada versão é baixado pelo botão Gerar meu link de download no canal #osx-reims do Discord dos membros; o caminho até ele está em Obtendo o OSX-REIMS.

É software experimental, em estágio alfa, fornecido sem garantias e sem suporte técnico. Dúvidas e problemas técnicos vão para o canal #osx-reims-chat, um espaço de ajuda entre membros (veja Pedir ajuda).

Como funciona

  1. Instalação. Você instala o pacote .deb do OSX-REIMS no Ubuntu Desktop 26.04 LTS.
  2. Preparação. O comando osx-reims setup prepara o computador: pacotes do sistema, acesso à GPU e ao KVM, Rust e o Reims vGPU, que é baixado e compilado no seu computador.
  3. Criação da VM. No menu, Create new VM cria a VM com disco vazio, OpenCore e o instalador do macOS: o Recovery, baixado dos servidores da Apple, ou uma imagem de instalador completo. Se você já tem um macOS instalado em outra VM, Import VM disk cria a VM a partir do disco QCOW2 dela.
  4. Instalação do macOS. Na primeira inicialização, a VM abre o instalador do macOS. Uma VM importada já inicia pelo macOS do disco.
  5. Uso diário. Pelo menu você inicia, desliga e reinicia as VMs, consulta os logs e faz a manutenção do computador. Cada VM guarda as próprias configurações — memória, processadores, tela, servidor gráfico, GPU, rede, som —, então iniciá-la é uma tecla, e uma VM pode até abrir sozinha quando o computador é ligado. Uma VM inteira também pode virar um arquivo de backup e ser restaurada depois.

O que cada VM recebe

  • EFI pronta. Cada VM já vem com o OpenCore configurado; você não precisa montar uma EFI. Quatro arquivos que ela usa (AppleMCEReporterDisabler.kext, VMHide.kext, ReimsVgpu.kext e HfsPlus.efi) são baixados das suas origens na criação da VM, com a impressão digital conferida, e guardados para as próximas — veja Licença.
  • Identidade própria. Número de série, MLB, UUID, ROM e endereço MAC são gerados para cada VM, então duas VMs nunca compartilham a mesma identidade.
  • Aceleração gráfica. O macOS usa a GPU virtual do Reims vGPU, com o driver da própria Apple, e o trabalho gráfico vai para a GPU do computador via Vulkan. No macOS Tahoe, o ReimsVgpu.kext faz o driver aproveitar mais a GPU.
  • Rede e som. A VM acessa a rede por NAT ou, com a ponte ligada, com um endereço próprio na rede do computador. O som do macOS sai pelo servidor de som do Ubuntu.
  • Configurações próprias. Memória, processadores, tela (janela ou tela cheia), servidor gráfico, OpenCore, GPU, taxa de atualização, rede e som ficam salvos na pasta da VM e viram o padrão dela. Veja Configurações da VM.

Onde ficam os arquivos

Caminho O que é
/opt/osx-reims/ O programa, instalado pelo pacote, com a licença em assets/licenses/
/opt/osx-reims/logs/ Um log por ação; o mais recente também fica em latest.log
/opt/osx-reims/cache/ Recovery baixado da Apple, reaproveitado nas próximas criações
/opt/osx-reims/full/ Imagens de instalador completo, oferecidas pelo menu na criação
/opt/osx-reims/state/ Resultado do setup e registro do aceite da licença
/opt/osx-reims/backup/ Os backups das VMs, um arquivo por backup
/opt/reims-vgpu/ O Reims vGPU, baixado e compilado pelo setup
/opt/reims-vgpu/vm/disks/rails/ As VMs, uma pasta macos-<ID> para cada uma, com a identidade e as configurações dela

Próximos passos