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.3.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 versão do QEMU com uma GPU virtual paravirtualizada, que usa Vulkan para acelerar os gráficos do macOS.

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

Nota

O OSX-REIMS é exclusivo para membros com assinatura ativa no nível Hackintosh - Avançado do Universo Hackintosh. O pacote de cada versão é publicado no canal #osx-reims do Discord dos membros; o caminho até ele está em Obtendo o OSX-REIMS.

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.

O que cada VM recebe

  • EFI pronta. Cada VM já vem com o OpenCore configurado; você não precisa montar uma EFI.
  • 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, que leva o trabalho gráfico para a GPU do computador via Vulkan.

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/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

Próximos passos