Pular para o conteúdo
OSX-REIMS
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.3.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/ e state/ Instaladores, imagens completas, logs e estado, 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)

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

Exemplo, só para um comando:

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

Arquivo /etc/osx-reims.conf

Para definir REIMS_ROOT, RAILS_DIR ou REIMS_VGPU_REF 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
  • 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.
  • 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.

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.

Qual OpenCore inicia a VM

Cada VM vem com um disco de inicialização próprio, com o OpenCore. Depois da primeira inicialização, o start pergunta qual OpenCore usar:

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 que você instalou na partição EFI do disco do macOS
  • macOS disk só funciona depois que você mesmo instala o OpenCore na EFI do disco do macOS, e só é oferecida para VMs que já passaram pela primeira inicialização.
  • A escolha fica salva e vira o padrão daquela VM.
  • 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.

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.