Instalação

Antes de começar#

Confira se o computador atende aos requisitos: Ubuntu Desktop 26.04 LTS de 64 bits, virtualização habilitada no BIOS/UEFI, GPU com Vulkan e o driver instalado, pelo menos 12 GB livres e conexão com a internet.

Você também vai precisar dos dois arquivos da versão, publicados no canal #osx-reims do Discord dos membros (veja Obtendo o OSX-REIMS):

• osx-reims_0.3.0_amd64.deb, o pacote;
• osx-reims_0.3.0_amd64.deb.sha256, a soma de verificação.

1. Atualize o sistema#

Recomendado antes da primeira instalação:

sudo apt update && sudo apt full-upgrade

2. Confira o download#

Coloque os dois arquivos na mesma pasta, abra um terminal nela e rode:

sha256sum -c osx-reims_0.3.0_amd64.deb.sha256

A resposta deve terminar em OK. Se aparecer FAILED, baixe os arquivos de novo.

3. Instale o pacote#

sudo apt install ./osx-reims_0.3.0_amd64.deb

O ./ indica ao apt que o pacote é um arquivo local. No fim, a instalação mostra o próximo passo.

4. Prepare o computador#

Rode com o seu usuário normal:

osx-reims setup

Antes de mudar qualquer coisa, o setup pergunta:

1. Licença. Mostra o resumo da licença do OSX-REIMS. Responda y para aceitar, n para recusar ou r para ler o texto completo. Sem aceitar a licença, o OSX-REIMS não pode ser usado.
2. Versão do Reims vGPU (só na primeira vez). Escolha 1 para a versão testada com esta versão do OSX-REIMS (recomendado) ou 2 para a mais recente, ainda não testada. Dá para trocar depois com osx-reims update-reims.

Depois, ele prepara o computador:

• instala os pacotes do sistema necessários;
• adiciona o seu usuário aos grupos kvm, render e video;
• configura o KVM (ignore_msrs), já na sessão atual e para as próximas inicializações;
• instala o Rust com o rustup;
• baixa o Reims vGPU em /opt/reims-vgpu e o compila.

Na primeira vez, a compilação costuma levar de 5 a 15 minutos, dependendo do computador e da conexão.

5. Saia e entre de novo, se for pedido#

Quando o setup adiciona o seu usuário a grupos, ele avisa no final: saia da sessão e entre de novo (ou reinicie o computador) antes de usar o OSX-REIMS.

6. Crie a primeira VM#

Abra OSX-REIMS no menu de aplicativos, ou rode osx-reims no terminal, e escolha Create new VM. O passo a passo está em Primeira VM.

Se você já tem um macOS instalado em outra VM, como no OSX-PROXMOX, escolha Import VM disk para usar o disco dela. Veja Importar uma VM.

Confira se está tudo pronto#

A qualquer momento, rode:

osx-reims doctor

O doctor confere tudo o que o setup prepara, sem mudar nada e sem pedir senha, e diz como corrigir cada problema. No fim, ele mostra o caminho do log: é esse arquivo que você compartilha no canal de suporte. O log não contém número de série nem outros dados de identidade das VMs.

Para conferir se os arquivos instalados estão intactos, rode dpkg --verify osx-reims. Se o comando não mostrar nada, está tudo certo.

Rodar o setup de novo#

O setup pode ser executado quantas vezes for preciso: etapas já concluídas são puladas, e em um computador pronto ele não muda nada.

Exemplo sem perguntas:

osx-reims setup -y --accept-license --tested

Para ver todas as opções, rode osx-reims setup --help.