Documentação · Começando
Visão geral
O que é o vGPU OS, como ele se relaciona com o OSX-REIMS e o que acontece do pendrive ao macOS.
Esta documentação corresponde ao vGPU OS 0.1.2, em estágio alfa. Telas e comandos podem mudar entre versões; para saber a versão instalada, use vgpu-os version.
O vGPU OS é um sistema operacional dedicado, baseado no Debian 13 (trixie), que existe só para rodar o OSX-REIMS (abre em nova aba). Ele é distribuído como uma ISO inicializável: você grava em um pendrive, instala em um disco e o computador passa a ligar direto no console das suas VMs macOS.
Uma segunda forma de usar o OSX-REIMS
O vGPU OS não substitui o OSX-REIMS no Ubuntu. São dois caminhos para o mesmo resultado:
| Caminho | Para quem | O que você mantém |
|---|---|---|
Ubuntu Desktop + pacote .deb do OSX-REIMS |
Quem já usa o Ubuntu e quer as VMs ao lado do resto | O Ubuntu, a área de trabalho e os drivers |
| vGPU OS (ISO) | Quem quer um computador só para as VMs macOS | Nada além das VMs: o sistema cuida do resto |
Nos dois casos, o OSX-REIMS cria as mesmas VMs, com a mesma EFI integrada, e busca o Reims vGPU na mesma origem, compilando-o no seu computador.
O que vem no vGPU OS
- Debian 13 mínimo, sem ambiente de área de trabalho, gerenciador de login ou gerenciador de arquivos.
- Um instalador de texto que ocupa um disco inteiro (UEFI, x86_64).
- Um primeiro setup que confere a rede, examina o hardware, instala só os drivers de vídeo de que o computador precisa, instala o OSX-REIMS e prova que os gráficos funcionam.
- Uma sessão dedicada: o console do OSX-REIMS em tela cheia, com a janela do macOS aberta no mesmo compositor Wayland. O Linux por baixo fica fora do caminho.
- Uma tela de carregamento entre o menu de boot e a sessão, para um computador que está iniciando nunca parecer travado.
O que não vem na ISO, de propósito: driver proprietário da NVIDIA, CUDA, drivers Vulkan, firmware de GPU e o Reims vGPU. Tudo isso é instalado depois, a partir da origem oficial de cada um. Veja GPUs e drivers.
Do pendrive ao macOS
- Obtenha a ISO no canal #vgpu-os do Discord.
- Grave o pendrive e instale: escolha o disco, confirme, defina a senha.
- O primeiro setup roda sozinho na primeira inicialização, com o cabo de rede conectado.
- O console do OSX-REIMS abre, mostra a licença e prepara o ambiente (compila o Reims vGPU).
- Crie a primeira VM no OSX-REIMS e instale o macOS. A partir daí, veja Uso diário.
Nota
As telas do vGPU OS e do OSX-REIMS são em inglês. Esta documentação cita os textos das telas como eles aparecem.
Quem faz o quê
- vGPU OS instala o sistema, prepara o hardware e a sessão e entrega a máquina ao OSX-REIMS.
- OSX-REIMS cria, executa e mantém as VMs macOS. A documentação dele está em osx-reims.com (abre em nova aba).
- Reims vGPU é a GPU virtual com aceleração via Vulkan usada pelas VMs, um projeto de código aberto de terceiros: reims-vgpu.com (abre em nova aba).
O OSX-REIMS não depende do vGPU OS: ele continua funcionando igual no Ubuntu, e o vGPU OS o usa apenas pelas interfaces que já existiam.
Estágio alfa
O vGPU OS 0.1.2 é software experimental, fornecido sem garantias e sem suporte técnico. Ele ocupa um disco inteiro, ainda não tem atualização no lugar e se destina a estudos e testes — não a dados de que você dependa. Uma VM macOS não substitui um Mac.