Pular para o conteúdo
Documentação: Notas de versão

Documentação · Sobre

Notas de versão

O que mudou em cada versão do OSX-REIMS.

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.

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-pci do 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 (tecla 6); pelo terminal, osx-reims backup e osx-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 com osx-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+Super juntas 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 setup aumenta o vm.max_map_count do sistema, de que o Reims vGPU precisa para VMs com bastante memória, e o doctor confere. 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-reims precisa de 3 GB livres ao lado do Reims vGPU (antes, 2 GB).
  • doctor ganhou 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 setup registra 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 arquivo GUEST_IMPORT deixado 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, o start usa outra GPU e diz por quê, e o doctor avisa.
  • 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 o setup e o update-reims seguintes recusavam a pasta. Agora tudo volta ao lugar a cada saída.
  • Em um computador com FORCE_SCREEN em /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_FILE em /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 HideVerbose na 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 start mostra o resumo e oferece S para iniciar, C para mudar uma configuração ou Q para 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 .deb que 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 setup nã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, o osx-reims setup pede o aceite de novo. Veja Licença.
  • Três componentes da EFI passam a ser baixados na criação da VM. AppleMCEReporterDisabler.kext, VMHide.kext e HfsPlus.efi nã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 --all não apagava a pasta cache/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 (tecla 2), 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 para 3, 4 e 5.
  • 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-reims em 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 setup mostra a licença e pede o aceite antes de mudar qualquer coisa; com -y, use --accept-license. Criar e iniciar VMs, o update-reims e o console esperam até a licença ser aceita, e o doctor mostra a situação.
  • Escolha da versão do Reims vGPU. Na primeira execução, o setup pergunta se o computador segue a versão testada, que é o padrão, ou a mais recente, não testada (--tested, --latest). O update-reims pergunta 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-reims volta para o commit anterior e o compila de novo.
  • Verificação dos arquivos instalados. dpkg --verify osx-reims confere 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 o setup ou o update-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 o sudo e 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 S para rodar o setup. 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 do setup.
  • Configuração opcional em /etc/osx-reims.conf para REIMS_ROOT, RAILS_DIR e REIMS_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.