Solução de problemas

Comece pelo doctor#

osx-reims doctor

No console, o mesmo está em Maintenance › Check this computer.

O doctor confere o sistema, a GPU, o acesso ao KVM, o Reims vGPU e os arquivos do OSX-REIMS. Ele não muda nada, não pede senha e não usa a internet. Cada verificação aparece como OK, aviso ou falha, com uma dica de como corrigir. No fim, ele mostra o total e o caminho do log.

Para testar também a conexão com o GitHub e com os servidores do Rust, que o setup usa:

osx-reims doctor --online

Resultados comuns do doctor#

Quando a dica é Run: osx-reims setup, rodar o setup de novo é seguro: ele só refaz o que falta.

Mensagens comuns#

"The environment is not ready"#

O console mostra esse aviso no primeiro uso ou depois de uma atualização do OSX-REIMS, com o motivo logo abaixo, como a licença não aceita ou o setup ainda não executado. Pressione S para rodar o setup.

"Virtualization (KVM) is not available in this session yet"#

O setup adicionou o seu usuário aos grupos kvm, render e video, mas a mudança só vale em uma nova sessão. Saia da sessão e entre de novo, ou reinicie o computador.

"Virtualization (KVM) is not available on this computer"#

A virtualização de hardware está desligada ou não é suportada. Habilite Intel VT-x ou AMD-V no BIOS/UEFI e reinicie.

"The OSX-REIMS license has not been accepted on this computer"#

Rode osx-reims setup e aceite a licença. Isso também acontece quando uma nova versão do OSX-REIMS traz um texto de licença novo.

"The VM boot program is outdated"#

Costuma aparecer depois de instalar uma nova versão do OSX-REIMS. Rode osx-reims setup. A mensagem "This version of OSX-REIMS does not match the VM boot program" tem a mesma solução.

"Reims vGPU was changed outside setup"#

O Reims vGPU em /opt/reims-vgpu não está no commit que o setup compilou. A VM ainda pode iniciar; se falhar, rode osx-reims setup.

"Shut down all VMs first"#

O update-reims só roda com todas as VMs desligadas. Desligue-as pelo macOS e tente de novo.

"A VM is being created right now and is using the cache"#

O cache não pode ser limpo enquanto uma VM está sendo criada. Espere a criação terminar e tente de novo.

"macOS has not shut down yet"#

Pode haver uma confirmação na janela da VM ou um app impedindo o desligamento. Confira a janela da VM e escolha esperar mais, forçar o desligamento ou cancelar.

A VM não inicia depois de mudar para a versão mais recente do Reims vGPU#

Volte para a versão testada:

osx-reims update-reims --tested

"Faulty (incomplete disk)" ou "Faulty (no base disk)"#

O disco da VM está incompleto ou falta o disco base. Não apague a VM antes de pedir ajuda: compartilhe o log da última execução dela.

A importação de uma VM falha#

As mensagens da importação e o que fazer em cada caso estão em Importar uma VM.

Logs#

Cada ação grava um log em /opt/osx-reims/logs/, com a ação, a data e a hora no nome, como osx-reims-start-20260914-213000.log. O mais recente também fica em latest.log, e os 100 mais recentes são mantidos. No console, View logs lista e abre os logs.

Se o seu usuário não puder escrever nessa pasta, o log vai para ~/.local/state/osx-reims/logs/, e a tela avisa.

Para um log mais detalhado, repita a ação com --debug.

Pedir ajuda#

1. Rode osx-reims doctor e anote o caminho do log mostrado no fim.
2. Encontre o log da execução com o problema, em View logs ou em /opt/osx-reims/logs/.
3. Compartilhe os dois logs no canal #osx-reims do Discord dos membros, dizendo o que você fez e o que aconteceu.

Os logs não trazem número de série, MLB, UUID nem ROM das VMs, e o log do doctor não traz nenhum dado de identidade delas. Compartilhar logs nos canais de suporte do Universo Hackintosh é permitido pela licença.

Arquivos instalados intactos#

dpkg --verify osx-reims

Se o comando não mostrar nada, os arquivos instalados estão intactos. Se mostrar arquivos alterados, instale o pacote de novo.