Documentação · Começando
Visão geral
O que é o OSX-REIMS, como ele funciona e onde ficam os arquivos no seu computador.
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
- Instalação. Você instala o pacote
.debdo OSX-REIMS no Ubuntu Desktop 26.04 LTS. - Preparação. O comando
osx-reims setupprepara o computador: pacotes do sistema, acesso à GPU e ao KVM, Rust e o Reims vGPU, que é baixado e compilado no seu computador. - 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.
- Instalação do macOS. Na primeira inicialização, a VM abre o instalador do macOS. Uma VM importada já inicia pelo macOS do disco.
- 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.kexteHfsPlus.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.kextfaz 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
- Requisitos: o que o computador precisa ter.
- Obtendo o OSX-REIMS: como se tornar membro e baixar o pacote no Discord.
- Instalação: instalação do pacote e preparação do Ubuntu.
- Primeira VM: criar a VM e instalar o macOS.
- Importar uma VM: usar o disco de um macOS já instalado em outra VM.
- Configurações da VM: memória, processadores, tela, servidor gráfico, GPU, rede, som e início automático.
- Backup e restauração: guardar uma VM inteira em um arquivo e colocá-la de volta.