Documentação · Sobre
Notas de versão
O que mudou em cada versão do OSX-REIMS.
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.
Mudanças relevantes para quem usa o OSX-REIMS, da versão mais recente para a mais antiga. Para instalar uma nova versão, veja Atualizar e remover.
0.6.0
Lançada em 19 de outubro de 2026. Testada com o Reims vGPU c099dd5a no Ubuntu Desktop 26.04 LTS. É a primeira versão publicada depois da 0.4.1 e inclui também as mudanças da 0.5.0, que não chegou a ser distribuída.
Importante
Vindo da 0.4.1: com todas as VMs desligadas, instale o pacote e rode osx-reims update-reims --tested. Até lá, o start avisa que esta versão precisa do novo Reims vGPU. Veja Atualizar e remover.
Novidades
- O Reims vGPU reescrito. O OSX-REIMS passa a usar o Reims vGPU depois da reescrita completa do projeto. O macOS vê o dispositivo gráfico
apple-gfx-pcido QEMU e usa o driver da própria Apple, e a biblioteca do Reims vGPU é ligada ao QEMU. A primeira atualização do Reims vGPU depois de instalar esta versão o leva para o commit novo e o compila de novo (cerca de 3 minutos). As VMs existentes continuam com os próprios discos, identidade e configurações. Veja Versão do Reims vGPU. - Backup e restauração. Uma VM inteira — disco do macOS, OpenCore, identidade e configurações — vira um único arquivo em
/opt/osx-reims/backup, que pode ser restaurado por cima dela ou como uma nova VM, com novo endereço MAC. No console, é o novo item Backup & Restore (tecla6); pelo terminal,osx-reims backupeosx-reims restore. Veja Backup e restauração. - Rede em ponte. Além do NAT, que continua o padrão, uma VM pode entrar na rede do computador com um endereço próprio, acessível pelos outros computadores (
--net bridge). A ponte é ligada uma vez em Maintenance › VM network ou comosx-reims network bridge on, e precisa de uma porta de rede com cabo. Veja Rede. - Som. Cada VM passa a ter som, ligado por padrão: o macOS toca pelo servidor de som do Ubuntu, do Ventura ao Tahoe, sem instalar driver. As VMs novas também têm o som de inicialização do OpenCore (
--audio,--no-audio). As VMs que já existiam recebem o som do macOS. - Taxa de atualização por VM. O macOS roda na taxa do monitor (automático) ou em uma taxa fixa, como 120 Hz (
--refresh). - ReimsVgpu.kext nas VMs com macOS Tahoe. O kext do reims-util faz o driver gráfico do macOS aproveitar mais a GPU no Tahoe, como o Metal em um Chrome com aceleração. Como os outros componentes de terceiros da EFI, ele é baixado da origem na criação ou importação da VM, com a impressão digital conferida. Vale para as VMs novas.
- Dispositivo IOSurface do Reims vGPU, nas VMs cujo QEMU o tem, para o driver gráfico portado do macOS 26.4 e posteriores. O driver da Apple o ignora, e a VM inicia como antes em uma compilação sem ele.
- OpenCore em tela cheia. O seletor do OpenCore, o logo da Apple e o Recovery inteiro (incluindo o instalador e o Utilitário de Disco) passam a ocupar a tela na resolução da VM, sem tarjas pretas. Vale para as VMs novas.
Mudanças
- Janela da VM nova. A janela é a do próprio Reims vGPU: clique nela para o macOS receber o teclado e pressione
Ctrl+Alt+Superjuntas para devolvê-lo ao Ubuntu (antes,Ctrl+Alt+Esc). Fechar a janela desliga a VM na hora. Em tela cheia, a resolução do macOS, 1920 × 1080, é ajustada ao monitor. - Requisitos. O
setupaumenta ovm.max_map_countdo sistema, de que o Reims vGPU precisa para VMs com bastante memória, e odoctorconfere. A primeira preparação precisa de 4 GB livres na pasta pessoal para o Rust (antes, 3 GB), além dos 10 GB ao lado do Reims vGPU. Os pacotes do sistema usados na compilação mudaram, e o zstd passa a ser uma dependência. rebuild-reimsprecisa de 3 GB livres ao lado do Reims vGPU (antes, 2 GB).doctorganhou as linhas Memory maps, GPU memory access, Large GPU buffers, VM memory, VM network, Sound e Backups, e a linha "Boot toolchain" virou Build toolchain.- GPU escolhida. O
setupregistra a GPU em que as VMs rodam por padrão (a escolha do próprio Reims vGPU), e não a primeira que o Vulkan lista, que costuma ser a integrada em um computador com placa de vídeo.
Removido
- A configuração memória da GPU (
--guest-import,C›G) e a cópia automática em GPUs integradas Intel e AMD: o Reims vGPU reescrito não tem mais essa escolha. Um arquivoGUEST_IMPORTdeixado na pasta da VM é ignorado. - VirtualSMC, da EFI das VMs novas: o dispositivo SMC do QEMU faz esse papel. As VMs existentes mantêm o próprio OpenCore.
Correções
- GPU sem
VK_EXT_external_memory_host, como a NVIDIA com o driver aberto nouveau (NVK): a VM fechava dois segundos depois de abrir. Agora uma GPU assim não é oferecida, ostartusa outra GPU e diz por quê, e odoctoravisa. - Janela preta em GPUs NVIDIA em compositores sem sincronização explícita, como o do vGPU OS. O OSX-REIMS passa a aplicar correções próprias ao Reims vGPU durante a compilação, desfeitas logo depois.
- Seletor do OpenCore, logo da Apple e Recovery a cerca de 10 quadros por segundo: passam a ser desenhados a cerca de 60. O Recovery continua sem aceleração gráfica, porque a imagem de Recovery da Apple não tem driver para o dispositivo.
- Uma compilação interrompida (
Ctrl+C, um erro) deixava o Reims vGPU com arquivos alterados, e osetupe oupdate-reimsseguintes recusavam a pasta. Agora tudo volta ao lugar a cada saída. - Em um computador com
FORCE_SCREENem/etc/osx-reims.conf, a pergunta da tela sugeria a janela e, com Enter, salvava a janela por cima da escolha do computador. Agora ela sugere o que a inicialização usaria.
0.5.0
Versão interna de 13 de outubro de 2026, não distribuída aos membros. As mudanças chegaram aos membros com a 0.6.0. Testada com o Reims vGPU 69a57dd6.
Novidades
- Instalador de novo.
start --attach-installer, ou Installer no menu de configurações (C›I), conecta de novo o instalador com que a VM foi criada, em uma única inicialização: para uma instalação interrompida no meio, que antes exigia apagar e recriar a VM, ou para reinstalar ou reparar o macOS. O disco da VM fica como está. Veja Instalador de novo. osx-reims logs. Lista os logs das execuções recentes e como cada uma terminou, como o View logs do console; com--json, para um programa.osx-reims list --json. A lista das VMs, com o estado, a versão do macOS e as configurações de cada uma, como um objeto JSON, para um programa ler. O painel web do vGPU OS é quem usa.- Aviso na tela principal (
CONSOLE_NOTICE_FILEem/etc/osx-reims.conf): a primeira linha de um arquivo mantido por outro programa aparece na tela principal do console. O vGPU OS mostra ali o endereço do painel web. Veja Configuração avançada. start --install-esp, com--opencore esp: instala o OpenCore da VM na EFI vazia do disco do macOS antes de iniciar, como o menu faz.
Mudanças
- A VM recebe todos os processadores configurados. O programa de inicialização limitava a 8 os processadores de uma VM no Reims vGPU, sem avisar: uma VM configurada com 31 iniciava com 8. Agora ela inicia com o que foi configurado (de 1 a 32).
0.4.1
Lançada em 28 de setembro de 2026. Testada com o Reims vGPU 69a57dd6 no Ubuntu Desktop 26.04 LTS. É a primeira versão baixada pelo botão Gerar meu link de download, no canal #osx-reims do Discord (veja Obtendo o OSX-REIMS).
Mudanças
- EFI atualizada: OpenCore 1.0.8. A EFI que o OSX-REIMS copia para cada VM passa a usar o OpenCore 1.0.8 RELEASE, já com a nova opção
HideVerbosena configuração, o VirtualSMC 1.3.8 e o AppleALC 1.9.8. Vale para as VMs criadas ou importadas a partir desta versão; as VMs que já existem continuam com a EFI delas.
0.4.0
Lançada em 26 de setembro de 2026. Testada com o Reims vGPU 69a57dd6 no Ubuntu Desktop 26.04 LTS.
Novidades
- Configurações salvas por VM, e um início que para de perguntar. Memória e processadores passam a ser salvos em cada VM, como a tela, o servidor gráfico e o OpenCore. Com todas as configurações salvas, o
osx-reims startmostra o resumo e ofereceSpara iniciar,Cpara mudar uma configuração ouQpara cancelar — uma VM sempre iniciada do mesmo jeito abre com uma tecla. Veja Configurações da VM. - Tela cheia. A VM pode ocupar o monitor inteiro, sem decoração de janela e sem o Ubuntu atrás dela. A escolha é de cada VM (
--fullscreen,--windowed). - Servidor gráfico: Wayland ou X11. Cada VM escolhe onde a janela abre. O padrão é o servidor que a sua sessão usa, então uma área de trabalho sem Wayland recebe o X11 (
--x11,--wayland). - GPU por VM. Em um computador com mais de uma GPU, cada VM pode rodar na GPU escolhida para ela, indicada pelo identificador de fabricante e dispositivo (
--gpu). Sem escolha, vale a GPU que o Reims vGPU seleciona: a dedicada. - Memória da GPU por VM. Em um computador em que a decisão automática não é a certa, cada VM pode fixar como a sua memória chega à GPU (
--guest-import auto|on|off). - VMs dentro do macOS. Com a virtualização aninhada ligada, o macOS passa a rodar VMs próprias — Docker, VirtualBox, o emulador do Android. Precisa de um computador Intel (
--nested). - Início automático. Uma VM pode abrir sozinha quando o computador é ligado, e o OSX-REIMS oferece ligar o login automático do Ubuntu, para que ligar a máquina termine no macOS:
osx-reims autostart on <VM>. - OpenCore no disco do macOS. Escolher macOS disk agora lê a EFI daquele disco e oferece o que couber: usar o OpenCore que já está lá ou instalar o da VM, com a mesma identidade (número de série), o que antes era uma cópia feita à mão de dentro do macOS. Uma EFI que já existe nunca é sobrescrita: ela é movida inteira para
EFI.osx-reims-bak, na mesma partição. Para voltar, basta escolher o disco de inicialização da VM de novo. osx-reims update. Instala uma versão nova do OSX-REIMS a partir do pacote.debque você baixou do Discord, comparando as versões — o que o clique duplo no arquivo não faz. No console, é Maintenance › Update OSX-REIMS. Veja Atualizar e remover.- Aviso de versão nova. A tela principal do console mostra uma linha quando existe uma versão mais nova publicada. O console lê a última verificação salva no computador e faz a próxima em segundo plano, no máximo uma por dia, então a tela nunca espera pela internet nem falha por causa dela. É o único endereço que o OSX-REIMS consulta por conta própria, e pode ser desligado.
- Recompilar o Reims vGPU do zero.
osx-reims rebuild-reims, ou Maintenance › Rebuild Reims vGPU, compila o QEMU-Reims de novo no mesmo commit, para uma compilação que parou de funcionar depois de uma atualização do sistema. A compilação atual é guardada e só é removida quando a nova passa nas verificações. Veja Versão do Reims vGPU.
Mudanças
- A tela do
setupnão acumula mais o que já foi respondido. Aceitar a licença redesenha a tela, com uma linha no lugar do resumo de onze linhas (✓ License accepted), e as etapas começam do alto. O histórico continua na rolagem do terminal. - As mensagens que dizem onde baixar o pacote agora citam o canal oficial do Discord, e não um endereço: o
.debé entregue aos membros do canal e nunca ficou em um endereço aberto. - O rodapé do console passa a dizer
GPU virtualization powered by Reims vGPU.
Correções
- A janela da VM agora abre em ambientes sem Wayland: as sessões Cinnamon, MATE e Xfce do Linux Mint e qualquer outra sessão X11. A VM rodava sem janela e nada dizia o motivo.
- Computadores cuja única GPU é integrada (um Core i9-14900K sem placa de vídeo, uma APU da AMD) instalavam o macOS e depois paravam na tela de boas-vindas, cinza, ou reiniciavam a VM em laço. Agora o OSX-REIMS manda o Reims vGPU copiar a memória da VM em vez de entregá-la à GPU, e a mesma VM passa da tela de boas-vindas. Um computador que também tem GPU dedicada roda nela e não é afetado.
0.3.1
Lançada em 16 de setembro de 2026. Testada com o Reims vGPU 69a57dd6 no Ubuntu Desktop 26.04 LTS.
Mudanças
- Licença de uso na versão 1.1. O texto passa a separar com clareza o que é do OSX-REIMS e o que é de terceiros: as restrições valem para o OSX-REIMS em si e não alcançam os componentes de outros autores, que seguem as próprias licenças. O script de inicialização
boot-x86-uniha.sh, derivado do Reims vGPU, é declarado LGPL-3.0-or-later. Como o texto mudou, oosx-reims setuppede o aceite de novo. Veja Licença. - Três componentes da EFI passam a ser baixados na criação da VM.
AppleMCEReporterDisabler.kext,VMHide.kexteHfsPlus.efinão são mais distribuídos no pacote, porque não foi identificada licença de redistribuição para eles nas suas origens. Ao criar ou importar uma VM, o OSX-REIMS os baixa direto da origem, confere a impressão digital (SHA-256) fixada na versão e os copia para a EFI daquela VM. Os arquivos obtidos são idênticos aos que o pacote trazia antes, então nada muda no funcionamento das VMs.- Os endereços são presos a uma versão exata, nunca a "a mais recente", e uma impressão digital diferente da esperada interrompe a operação sem tocar na VM.
- Os arquivos ficam em
/opt/osx-reims/cache/third-party/e valem para as próximas VMs: o download acontece uma vez só. Com o cache cheio, criar uma VM não precisa de internet para esta etapa. - Na prática, a primeira criação de VM depois de instalar ou de limpar o cache precisa de conexão. Veja Requisitos.
Correções
clean-cache --allnão apagava a pastacache/third-party/: um cache que tivesse só os componentes da EFI aparecia como vazio e nada era removido. A listagem, o tamanho total mostrado na confirmação e a remoção agora incluem essa pasta, então o espaço anunciado é o espaço realmente liberado.clean-cache <versão>continua apagando só aquele instalador.
0.3.0
Lançada em 15 de setembro de 2026. Testada com o Reims vGPU 69a57dd6 no Ubuntu Desktop 26.04 LTS.
Novidades
- Importar disco de VM.
osx-reims import, ou Import VM disk no console (tecla2), cria uma VM a partir do disco QCOW2 de um macOS já instalado em outra VM, como no OSX-PROXMOX. O disco é copiado para a nova VM, que recebe identidade e disco de inicialização próprios; o arquivo original pode ser apagado depois. Veja Importar uma VM. - Ícone do aplicativo. O lançador OSX-REIMS no menu de aplicativos passa a ter ícone próprio.
Mudanças
- Menu principal do console. Import VM disk é a tecla
2; Manage VMs, View logs e Maintenance passaram para3,4e5. - Janela do console. Aberto pelo lançador, o console usa uma janela de 160 × 35 caracteres, sem alterar as preferências do seu terminal. Rodar
osx-reimsem um terminal já aberto não muda o tamanho dele. - Instalação. A linha
Notice: Download is performed unsandboxed as root, que o apt pode mostrar ao instalar um pacote da pasta pessoal, é normal.
0.2.0
Lançada em 14 de setembro de 2026. Testada com o Reims vGPU 69a57dd6 no Ubuntu Desktop 26.04 LTS.
Novidades
- Licença de uso. O
osx-reims setupmostra a licença e pede o aceite antes de mudar qualquer coisa; com-y, use--accept-license. Criar e iniciar VMs, oupdate-reimse o console esperam até a licença ser aceita, e odoctormostra a situação. - Escolha da versão do Reims vGPU. Na primeira execução, o
setuppergunta se o computador segue a versão testada, que é o padrão, ou a mais recente, não testada (--tested,--latest). Oupdate-reimspergunta de novo, e a manutenção do console ganhou Update Reims vGPU. - Volta automática. Se o novo commit do Reims vGPU não compilar ou não passar nas verificações, o
update-reimsvolta para o commit anterior e o compila de novo. - Verificação dos arquivos instalados.
dpkg --verify osx-reimsconfere se os arquivos do pacote estão intactos.
Mudanças
- A pasta EFI incluída no pacote não carrega mais uma identidade, então uma cópia dela não clona a identidade de uma VM. Cada VM nova continua recebendo a própria identidade.
Correções
setup: o aviso final depois de adicionar o usuário aos grupos listava os grupos duas vezes.setup: no Ubuntu 26.04, a senha era pedida para instalar um pacote do sistema logo depois de ele ter sido instalado (pkg-config, que agora épkgconf).
0.1.0
Lançada em 14 de setembro de 2026. Testada com o Reims vGPU 69a57dd6 no Ubuntu Desktop 26.04 LTS.
Novidades
- Pacote Debian. Instalação com o
apt. A mensagem no fim indica se é preciso rodar osetupou oupdate-reims, e a remoção não apaga nada do que você criou. osx-reims setup. Prepara um Ubuntu 26.04 recém-instalado, como usuário normal, usando osudoe a internet só nas etapas que precisam deles. Em um computador pronto, não muda nada.osx-reims doctor. Diagnóstico sem mudanças, com uma dica para cada problema e um log para compartilhar ao pedir ajuda.osx-reims update-reims. Leva o Reims vGPU para o commit testado com a versão do OSX-REIMS e o compila de novo, com as VMs desligadas.- Identidade única por VM. Cada VM nova recebe número de série, MLB, UUID, ROM e endereço MAC próprios. Os valores completos nunca aparecem na tela nem nos logs.
- Lançador. OSX-REIMS no menu de aplicativos abre o console em uma janela de terminal.
- Console. Enquanto o ambiente não está pronto, o menu mostra o motivo e oferece
Spara rodar osetup. A manutenção ganhou Check this computer e Prepare environment. - Mensagens mais claras ao iniciar uma VM: falta de
/dev/kvm, grupos que só valem depois de um novo login e Reims vGPU alterado fora dosetup. - Configuração opcional em
/etc/osx-reims.confparaREIMS_ROOT,RAILS_DIReREIMS_VGPU_REF.
Correções
- Linhas
FAILURE:falsas nos logs.
0.0.1
Primeira versão: o console e os comandos create, list, start, stop, reset, poweroff, term, delete e clean-cache.