Pular para o conteúdo
Documentação: Configuração avançada

Documentação · Ajuda

Configuração avançada

Pastas, variáveis de ambiente, /etc/osx-reims.conf e a escolha do OpenCore.

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.

A maioria das pessoas não precisa mudar nada aqui. Estas opções servem para guardar as VMs em outro lugar, usar o Reims vGPU em outra pasta ou entender as escolhas avançadas de inicialização.

Pastas padrão

Pasta Conteúdo
/opt/osx-reims/ O programa, instalado pelo pacote
/opt/osx-reims/cache/, full/, logs/, state/ e backup/ Instaladores, imagens completas, logs, estado e backups, criadas pelo setup para o seu usuário
/opt/reims-vgpu/ O Reims vGPU (REIMS_ROOT)
/opt/reims-vgpu/vm/disks/rails/ As VMs (RAILS_DIR)
/opt/reims-vgpu/vm/disks/rails/macos-<número>/ Uma VM, com a identidade e as configurações dela

Variáveis de ambiente

Variável O que define Padrão
REIMS_ROOT Pasta do Reims vGPU /opt/reims-vgpu
RAILS_DIR Pasta das VMs <REIMS_ROOT>/vm/disks/rails
MACRECOVERY Caminho alternativo do macrecovery.py, que baixa o Recovery da Apple O incluído no pacote
QMP_TIMEOUT Segundos de espera por comando de controle enviado a uma VM em execução 5
NO_COLOR Desliga as cores no terminal Não definida
UPDATE_CHECK_URL Onde a versão publicada do OSX-REIMS é lida https://osx-reims.com.br/app/latest.json

Exemplo, só para um comando:

RAILS_DIR=/mnt/vms/rails osx-reims list

Arquivo /etc/osx-reims.conf

Para fixar uma opção de forma permanente, crie o arquivo opcional /etc/osx-reims.conf, com uma linha CHAVE=VALOR por opção:

# Pasta das VMs em outro disco
RAILS_DIR=/mnt/vms/rails
Chave O que define Padrão
REIMS_ROOT Pasta do Reims vGPU /opt/reims-vgpu
RAILS_DIR Pasta das VMs <REIMS_ROOT>/vm/disks/rails
REIMS_VGPU_REF O commit do Reims vGPU que o setup usa O commit testado
UPDATE_CHECK_URL Onde a versão publicada é lida; vazio desliga a verificação https://osx-reims.com.br/app/latest.json
HOST_PROFILE desktop ou appliance (abaixo) desktop
FORCE_SCREEN window ou fullscreen para todas as VMs deste computador Não definida
FORCE_BACKEND wayland ou x11 para todas as VMs deste computador Não definida
CONSOLE_NOTICE_FILE Um arquivo cuja primeira linha a tela principal do console mostra (abaixo) Não definida
SETUP_OS_ID, SETUP_OS_VERSION O sistema testado; o setup e o doctor avisam em qualquer outro ubuntu, 26.04
SETUP_OS_NAME O nome do sistema nas mensagens sobre ele e sobre o login Ubuntu
  • O arquivo só é usado se pertencer ao root e não puder ser alterado por outros usuários. Por isso, crie-o com sudo.
  • Linhas que começam com # são comentários, e um par de aspas em volta do valor é aceito.
  • Outras chaves são ignoradas e citadas no log.
  • Variáveis de ambiente têm prioridade sobre o arquivo.
  • O cabeçalho de cada log informa se o arquivo foi usado ou ignorado, e por quê.

Para escolher a versão do Reims vGPU, prefira o osx-reims update-reims a definir REIMS_VGPU_REF. Veja Versão do Reims vGPU.

FORCE_SCREEN e FORCE_BACKEND servem para um computador que sempre mostra a VM do mesmo jeito, como um totem. Eles vêm antes da escolha salva de cada VM e depois da resposta daquela inicialização, então --fullscreen, --windowed, --x11, --wayland e o menu de configurações continuam valendo.

Verificação de versão nova

O OSX-REIMS consulta um único endereço por conta própria: UPDATE_CHECK_URL, um JSON pequeno que diz qual é a versão publicada, o nome do pacote .deb dela e a impressão digital (SHA-256) desse arquivo. A verificação acontece no máximo uma vez por dia, em segundo plano, e nada é enviado além do pedido do arquivo. Para desligá-la, deixe a chave vazia:

UPDATE_CHECK_URL=

Com ela vazia, o OSX-REIMS não busca nada na internet por conta própria, e o osx-reims update continua instalando o pacote que você baixou — só não tem com o que comparar a versão nem a impressão digital.

Perfil do computador

HOST_PROFILE diz que tipo de computador é este:

  • desktop, o padrão e o que vale para qualquer instalação sem o arquivo: uma área de trabalho Linux comum, em que alguém instalou o pacote. Nada muda.
  • appliance: um computador cujo trabalho inteiro é o OSX-REIMS, instalado a partir de uma imagem, sem ambiente de área de trabalho e sem tela de login.

O valor é definido, nunca detectado; um valor desconhecido é registrado no log e lido como desktop. Em um appliance, o login automático não é oferecido (não há tela de login a pular), as mensagens do início automático dizem que a VM abre quando o computador inicia, e a tela de início da VM diz apenas como devolver o teclado e que o console volta quando a VM é desligada. O doctor mostra uma linha Host profile, e o cabeçalho de cada log tem uma linha Profile:.

Importante

Mudar RAILS_DIR não move as VMs existentes: elas continuam na pasta antiga e deixam de aparecer. A nova pasta precisa permitir escrita pelo seu usuário.

Aviso na tela principal

CONSOLE_NOTICE_FILE indica um arquivo que outro programa do computador mantém atualizado — o vGPU OS grava ali o endereço do painel web dele —, e a tela principal do console mostra a primeira linha desse arquivo abaixo de "Choose an option:". O arquivo precisa pertencer ao root ou ao usuário do console e não poder ser alterado por outros usuários; a linha precisa ter até 200 caracteres, sem caracteres de controle. Em qualquer outro caso, nada é mostrado. Enquanto espera uma tecla, a tela confere o arquivo a cada 3 segundos e se redesenha quando a linha muda. Sem a chave, a tela principal é a de sempre.

Qual OpenCore inicia a VM

Cada VM vem com um disco de inicialização próprio, com o OpenCore. Em uma VM instalada, o menu de configurações (C › O) oferece:

Opção --opencore O que é
VM boot disk image O OpenCore que veio com a VM. É o padrão e a opção recomendada
macOS disk esp O OpenCore na partição EFI do próprio disco do macOS

Com macOS disk, o disco do macOS passa a iniciar sozinho, sem nada ao lado dele.

  • A escolha fica salva e vira o padrão daquela VM. Ela só é oferecida para VMs que já passaram pela primeira inicialização.
  • Cada OpenCore tem a própria configuração. Trocar de um para o outro pode mudar a identidade que o macOS vê, como o número de série, e com ela o iCloud, o iMessage e o FaceTime. O start avisa antes de iniciar.
  • Ao voltar para VM boot disk, a ordem de inicialização do firmware é restaurada, para a VM iniciar de novo pelo próprio disco de inicialização. Não é preciso restaurar nada além disso.

Instalar o OpenCore na EFI do disco do macOS

Ao escolher macOS disk, o OSX-REIMS lê a EFI daquele disco e oferece o que couber com o que está nela:

A EFI O que é oferecido
já tem um OpenCore usá-lo como está, ou substituí-lo pelo da VM
ainda não tem OpenCore instalar o OpenCore desta VM nela
não existe, não é FAT ou não tem espaço nada: o motivo é mostrado e a VM continua com o disco de inicialização dela

O que é copiado é o OpenCore da própria VM, então a identidade (SMBIOS, número de série) vai com ele e o macOS continua vendo o mesmo computador. Nessa cópia, e só nela, o seletor de inicialização é desligado, porque há um único sistema a iniciar naquele disco: segure ESC enquanto a VM inicia para abri-lo de todo modo.

Importante

Uma EFI que já existe nunca é sobrescrita: EFI/OC e EFI/BOOT são movidos inteiros para EFI.osx-reims-bak, na mesma partição. Uma segunda instalação para em vez de substituir esse backup — abra a EFI de dentro do macOS e apague essa pasta para instalar de novo.

O disco do macOS é escrito uma única vez, no fim, e só nos blocos que mudaram (cerca de 9 MB). A escrita é lida de volta e comparada antes de a escolha ser salva, então uma falha em qualquer ponto deixa a VM iniciando exatamente como iniciava. A VM precisa estar desligada, e nada disso pede sudo: a partição é lida, alterada em um arquivo temporário e escrita de volta, nunca montada.

--opencore esp na linha de comando não instala sozinho: colocar uma EFI no disco do macOS muda aquele disco e é pedido pelo menu. A opção só recusa um disco sem nada para iniciar. Para dar essa resposta de antemão — um programa com uma pessoa por trás, como um painel web —, acrescente --install-esp: se a EFI não tiver OpenCore, o da VM é instalado nela antes, com as mesmas recusas do menu; um OpenCore que já está lá é usado como está, nunca substituído.

Uso sem perguntas

Os comandos aceitam -y para rodar sem perguntas, com os valores das opções ou os padrões. Para ver o comando de inicialização de uma VM sem iniciá-la:

osx-reims start 10 --dry-run

Todas as opções estão em Comandos.