GRUB (Português)

GRUB (GRand Unified Bootloader) é um gerenciador de boot. O GRUB atual também é chamado de GRUB 2. O GRUB original, ou GRUB Legacy, corresponde às versões 0.9x. Esta página descreve exclusivamente o GRUB 2.

Status de tradução: Esse artigo é uma tradução de GRUB. Data da última tradução: 2022-11-14. Você pode ajudar a sincronizar a tradução, se houver alterações na versão em inglês.

Sistemas UEFI

Instalação

Primeiro, instale os pacotes e efibootmgr: GRUB é o gerenciador de boot, enquanto efibootmgr é usado pelo script de instalação do GRUB para escrever entradas de inicialização para NVRAM.

Então, siga os seguintes passos para instalar o GRUB em seu disco:

1. Monte a partição de sistema EFI e, no restante da sessão, substitua esp com seu ponto de montagem.
2. Escolha um identificador de gerenciador de boot, aqui chamado . Um diretório com esse nome será criado em para armazenar o binário EFI e esse é o nome que aparecerá no menu de inicialização UEFI para identificar a entrada de inicialização do GRUB.
3. Execute o seguinte comando para instalar o aplicativo EFI do GRUB em e instalar seus módulos para . {{Nota|Certifique-se de instalar os pacotes e executar o comando do sistema no qual o GRUB será instalado como o gerenciador de boot. Isso significa que se você estiver inicializando a partir do ambiente de instalação live, você precisa estar dentro do chroot quando estiver executando . Se por algum motivo for necessário executar de fora do sistema instalado, anexe a opção com o caminho para o , por exemplo, --boot-directory=/mnt/boot.

   # grub-install --target=x86_64-efi --efi-directory=''esp'' --bootloader-id=GRUB

Após a conclusão da instalação acima, o diretório principal do GRUB está localizado em . Leia GRUB/Tips and tricks#Alternative install method para saber como especificar um local alternativo. Note que também tenta criar uma entrada no gerenciador de boot do firmware, chamado no exemplo acima -– isso pode, no entanto, falhar se suas entradas de inicialização estiverem lotadas; use efibootmgr para remover entradas desnecessárias.

Lembre-se de gerar o arquivo de configuração principal após finalizar a configuração.

Veja a solução de problemas do UEFI caso tenha problemas. Além disso, veja GRUB/Tips and tricks#UEFI further reading.

Sistemas BIOS

Instruções específicas de Tabela de Partição GUID (GPT)

Em uma configuração de BIOS/GPT, é necessária uma partição de inicialização de BIOS. O GRUB incorpora seu nessa partição.

Crie uma partição de mebibyte ( com fdisk ou gdisk) no disco sem sistema de arquivos e com o tipo de partição GUID .

• Selecione o tipo de partição para fdisk.
• Selecione o código de tipo de partição ef02 para gdisk.
• Para o parted defina/ative a opção bios_grub a partição.

Esta partição pode estar em qualquer ordem de posição, mas deve estar nos primeiros 2 TiB do disco. Esta partição precisa ser criada antes da instalação do GRUB. Quando a partição estiver pronta, instale o gerenciador de boot conforme as instruções abaixo.

O espaço antes da primeira partição também pode ser usado como partição de inicialização de BIOS, embora esteja fora da especificação de alinhamento da GPT. Como a partição não será acessada regularmente, problemas de desempenho podem ser desconsiderados, embora alguns utilitários de disco exibam um aviso sobre isso. Em fdisk ou gdisk crie uma nova partição a partir do setor 34 e abrangendo até 2047 e defina o tipo. Para que as partições visualizáveis comecem na base, considere adicionar essa partição por último.

Instruções específicas de Master Boot Record (MBR)

Normalmente, o intervalo pós-MBR (após a região de 512 bytes MBR e antes do início da primeira partição) em muitos sistemas particionados MBR é de 31 KiB quando os problemas de alinhamento do cilindro de compatibilidade do DOS são atendidos na tabela de partições. No entanto, uma lacuna pós-MBR de cerca de 1 a 2 MiB é recomendada para fornecer espaço suficiente para incorporar o do GRUB (). É aconselhável usar uma ferramenta de particionamento que suporte alinhamento de partições de 1 MiB para obter este espaço, bem como para satisfazer outros problemas de setor não-512-byte (que não estão relacionados à incorporação de ).

Instalação

Instale o pacote . (Ele vai substituir o se este ainda estiver instalado.) Então, execute:

# grub-install --target=i386-pc /dev/sdX

sendo usado deliberadamente, independentemente de sua arquitetura real, e o disco (não a partição) no qual o GRUB deve ser instalado. Por exemplo, o disco ou ou . Veja Arquivo de dispositivo#Nomes de dispositivos de bloco para uma descrição do esquema de nomeação de dispositivo de bloco.

Agora, você deve gerar o arquivo de configuração principal.

Se você usa LVM para seu , você pode instalar o GRUB em vários discos físicos.

Veja grub-install(8) e o manual do GRUB para mais detalhes no comando .

Configuração

Em um sistema instalado, o GRUB carrega o arquivo de configuração em cada inicialização. Você pode seguir #grub.cfg gerado para usar uma ferramenta ou #grub.cfg personalizado para uma criação manual.

grub.cfg gerado

Esta seção cobre apenas a edição do arquivo de configuração /etc/default/grub. Veja GRUB/Tips and tricks para mais informações.

Gerar o arquivo de configuração principal

Após a instalação, o arquivo de configuração principal precisa ser gerado. O processo de geração pode ser influenciado por uma variedade de opções em /etc/default/grub e scripts em .

Se você não tiver feito configurações adicionais, a geração automática determinará o sistema de arquivos raiz do sistema para inicializar o arquivo de configuração. Para que isso seja bem sucedido, é importante que o sistema seja inicializado ou "chrooted".

Use a ferramenta grub-mkconfig para gerar :

# grub-mkconfig -o /boot/grub/grub.cfg

Por padrão, os scripts de geração adicionam automaticamente entradas de menu para todos os kernels do Arch Linux instalados na configuração gerada.

Para adicionar automaticamente entradas para outros sistemas operacionais instalados, consulte #Detectando outros sistemas operacionais.

Você pode adicionar entradas adicionais ao menu editando e regerando . Ou você pode criar e adicioná-las lá. Alterações no não requerem reexecução do grub-mkconfig, já que /etc/grub.d/41_custom adiciona a declaração para o arquivo de configuração gerado.

Veja #Exemplos de entrada de menu de boot para mais exemplos de entradas de menu personalizadas.

Detectando outros sistemas operacionais

Para fazer com que o grub-mkconfig procure por outros sistemas instalados e adicioná-los automaticamente ao menu, instale o pacote e monte as partições das quais outros outros sistemas inicializam. Então, execute novamente o grub-mkconfig. Se você receber a seguinte saída: então edite /etc/default/grub e adicione/descomente:

GRUB_DISABLE_OS_PROBER=false

E tente novamente.

Dica: Você pode querer que o GRUB se lembre da última entrada de boot escolhida, veja GRUB/Tips and tricks#Recall previous entry.

Windows

Para o Windows instalado no modo UEFI, certifique-se de que a partição de sistema EFI contendo o Windows Boot Manager () esteja montada. Execute como root para detectar e gerar uma entrada para ele.

Para Windows instalado no modo BIOS, monte a partição de sistema do Windows (seu rótulo do sistema de arquivos deve ser ou SYSTEM). Execute como root para detectar e gerar uma entrada para ele.

Argumentos adicionais

Para passar argumentos adicionais personalizados para a imagem do Linux, você pode definir as variáveis e em /etc/default/grub. As duas são anexadas uma à outra e passadas ao kernel ao gerar entradas de inicialização comuns. Para a entrada de inicialização de recuperação, apenas é usado na geração.

Não é necessário usar ambos, mas pode ser útil. Por exemplo, você poderia usar , sendo o UUID da sua partição swap para permitir a continuação após hibernação. Isso geraria uma entrada de inicialização de recuperação sem o resumo e sem para suprimir mensagens do kernel durante uma inicialização a partir dessa entrada de menu. Porém, as outras entradas de menu (comuns) os teriam como opções.

Por padrão, o grub-mkconfig determina o UUID do sistema de arquivos raiz para a configuração. Para desabilitar isso, descomente .

Para gerar a entrada de recuperação do GRUB, você precisa garantir que GRUB_DISABLE_RECOVERY não esteja definido como em /etc/default/grub.

Veja Parâmetros do kernel para mais informações.

LVM

Atenção: O GRUB não possui suporte a volumes lógicos thin-provisioned.

Se você usa LVM para sua partição ou , certifique-se de que o módulo esteja pré-carregado:

RAID

O GRUB fornece um manuseio conveniente de volumes RAID. Você precisa carregar os módulos GRUB ou para permitir que você aborde o volume nativamente:

Por exemplo, se torna:

set root=(md/0)

sendo que um volume RAID particionado (p.ex., ) se torna:

set root=(md/0,1)

Para instalar o grub ao usar o RAID1 como partição (ou usando alojado em uma partição raiz RAID1), nos sistemas BIOS, simplesmente execute o grub-install em ambas as unidades, como:

# grub-install --target=i386-pc --debug /dev/sda
# grub-install --target=i386-pc --debug /dev/sdb

sendo que o vetor RAID 1 contendo está contido em ambos e /dev/sdb.

/boot criptografado

O GRUB também tem suporte especial para inicializar com um criptografado. Isto é feito desbloqueando um dispositivo de bloco LUKS para ler sua configuração e carregar qualquer initramfs e kernel dele. Esta opção tenta resolver o problema de ter uma partição de inicialização não criptografada.

Dica: /boot não precisa obrigatoriamente ser mantido em uma partição separada; ele também pode ficar sob a árvore de diretórios / da raiz do sistema.

Para ativar este recurso, criptografe a partição com que reside nela usando LUKS normalmente. Em seguida, adicione a seguinte opção para /etc/default/grub:

Esta opção é usada pelo grub-install para gerar o grub .

Certifique-se de instalar o grub depois de modificar esta opção ou criptografar a partição.

Sem mais alterações, você será solicitado duas vezes a informar uma senha: o primeiro para o GRUB desbloquear o ponto de montagem na inicialização, o segundo para desbloquear o sistema de arquivos raiz como implementado pelo initramfs. Você pode usar um initramfs para evitar isso.

LUKS2

GRUB 2.06 tem suporte limitado ao LUKS2. Veja GRUB bug #55093.

• Argon2id (padrão do cryptsetup) e Argon2i PBKDFs não são suportados (GRUB bug #59409), somente PBKDF2 é.
• grub-install não oferece suporte a criar uma imagem core que pudesse ser usada para desbloquear LUKS2. Veja os comentários abaixo ou em para uma solução de contorno.

Use grub-install conforme descrito na seção #Instalção. Porém, o binário EFI gerado não oferece suporte a LUKS2 e precisa ser substituído.

Crie . Substitua pela saída de . Use lvm/NomeDoGrupoDoVolume-NomeDoVolumeLógico em vez de se sua unidade raiz estiver em um volume lógico LVM dentro do volume LUKS.

Adicione se você usa LVM. Substitua por ou outro módulo de sistema de arquivos, se necessário. Substitua gcry_sha256 por ou se for necessário:

$ grub-mkimage -p /boot/grub -O x86_64-efi -c grub-pre.cfg -o /tmp/grubx64.efi luks2 part_gpt cryptodisk gcry_rijndael pbkdf2 gcry_sha256 ext2

Copie à ESP:

# install -v /tmp/grubx64.efi esp/EFI/GRUB/grubx64.efi

Se você inserir uma senha inválida durante a inicialização e terminar no shell de recuperação do GRUB, tente para montar todas (espera-se que apenas uma) partições criptografadas ou use para montar uma específica. Em seguida, prossiga com e normal como de costume.

Se você inserir uma senha correta, mas um erro for retornado imediatamente, certifique-se de que os módulos criptográficos corretos sejam especificados. Use e verifique se a função hash (SHA-256, SHA-512) corresponde aos módulos (gcry_sha256, ) instalados e o algoritmo PBKDF seja pbkdf2. O hash e o algoritmos de PBDKDF podem ser alterados para chaves existentes usando . Em circunstâncias normais, deve levar alguns segundos antes que a senha seja processada.

grub.cfg personalizado

Esta seção descreve a criação manual de entradas de inicialização do GRUB em em vez de confiar em grub-mkconfig.

Um arquivo de configuração básico do GRUB usa as seguintes opções:

• é a partição Y no disco X, números de partição iniciando em 1, números de disco iniciando em 0
• set default=N é a entrada de inicialização padrão que é escolhida após atingido um tempo limite para ação do usuário
• é o tempo M para aguardar em segundos para uma seleção de usuário antes da padrão ser inicializada
• é uma entrada padrão chamada
• define a partição de inicialização, onde os módulos de kernel e GRUB estão armazenados (o boot não precisa estar em uma partição separada e pode simplesmente ser um diretório sob a partição "root" ()

Exemplos de entrada de menu de boot

Para obter dicas sobre o gerenciamento de várias entradas do GRUB, por exemplo, ao usar os kernels e linux-lts, consulte GRUB/Tips and tricks#Multiple entries.

Para entradas de menu de inicialização de Archiso e Archboot, veja Multiboot USB drive#Boot entries.

Binarios de EFI

Ao iniciar o modo UEFI, o GRUB pode carregar outros binários EFI.

Dica: Para mostrar essas entradas de menu somente quando o GRUB é iniciado no modo UEFI, coloque-as na seguinte instrução if:

if [ ${grub_platform} == "efi" ]; then
	''coloque apenas entradas de menu UEFI aqui''
fi

Shell de UEFI

Você pode iniciar o UEFI Shell colocando-a na raiz da partição de sistema EFI e adicionando esta entrada de menu:

gdisk

Baixe o aplicativo EFI gdisk e copie para .

Carregando uma imagem de kernel unificada

Se você tiver uma imagem de kernel unificada gerada a partir de Secure Boot ou outro meio, você pode adicioná-lo ao menu de inicialização. Por exemplo:

GNU/Linux

Presumindo que outra distribuição esteja na partição :

Alternativamente, permita o GRUB pesquisar a partição correta pelo UUID ou label do sistema de arquivos:

menuentry "Outro Linux" {
        # presumindo que o UUID seja 763A-9CB6
	search --no-floppy --set=root --fs-uuid 763A-9CB6

        # pesquise pelo rótulo OUTRO_LINUX (certifique-se que o rótulo da partição não seja ambígua)
        #search --no-floppy --set=root --label OUTRO_LINUX

	linux /boot/vmlinuz (adicione aqui outras opções necessárias, por exemplo: root=UUID=763A-9CB6)
	initrd /boot/initrd.img (se outro kernel usa/precisa de um)
}

Se a outra distribuição já tiver uma pasta válida com o GRUB instalado, , kernel e initramfs, o GRUB poderá ser instruído a carregar esses outros arquivos de dinamicamente durante a inicialização. Por exemplo, para e a quarta partição GPT:

Ao escolher esta entrada, o GRUB carrega o arquivo do outro volume e exibe esse menu. Quaisquer alterações na variável de ambiente feitas pelos comandos no arquivo não serão preservadas após o retorno do configfile. Pressione para retornar ao primeiro menu do GRUB.

Windows instalado em modo UEFI/GPT

Este modo determina onde o carregador de boot do Windows reside e carrega-o após o GRUB quando a entrada do menu é selecionada. A principal tarefa aqui é encontrar a partição do sistema EFI e executar o carregador de boot a partir dela.

sendo que e $fs_uuid são obtidas com os dois comandos abaixo.

O comando $fs_uuid determina o UUID da partição de sistema EFI:

Como alternativa, é possível executar e ler o UUID da partição do sistema EFI a partir dele.

O comando determinará a localização da partição do sistema EFI, neste caso o disco rígido 0:

Estes dois comandos presumem o uso da ESP do Windows montada em esp. Pode haver diferenças entre maiúsculas e minúsculas no caminho para o arquivo EFI do Windows, com o Windows e tudo mais.

Windows instalado em modo BIOS/MBR

Ao longo desta seção, presume-se que sua partição do Windows é . Uma partição diferente mudará todas as instâncias de hd0,msdos1.

Em ambos exemplos é o UUID do sistema de arquivos que pode ser encontrado com o comando .

Para Windows Vista/7/8/8.1/10:

if [ "${grub_platform}" == "pc" ]; then
	menuentry "Microsoft Windows Vista/7/8/8.1/10 BIOS/MBR" {
		insmod part_msdos
		insmod ntfs
		insmod ntldr
		search --no-floppy --fs-uuid --set=root --hint-bios=hd0,msdos1 --hint-efi=hd0,msdos1 --hint-baremetal=ahci0,msdos1 ''XXXXXXXXXXXXXXXX''
		ntldr /bootmgr
	}
fi

Para Windows XP:

Usando rótulos

É possível usar rótulos do sistema de arquivos, nomes legíveis anexados ao sistemas de arquivos, ao usar a opção no . Primeiramente, tenha certeza de que seu sistema de arquivos tem um rótulo.

Então, adicione uma entrada usando rótulos. Um exemplo disso:

menuentry "Arch Linux, sessão texto" {
  search --label --set=root archroot
  linux /boot/vmlinuz-linux root=/dev/disk/by-label/archroot ro
  initrd /boot/initramfs-linux.img
}

Usando o shell de comandos

Como o MBR é muito pequeno para armazenar todos os módulos do GRUB, apenas o menu e alguns comandos básicos residem nele. A maior parte da funcionalidade do GRUB permanece nos módulos em , que são inseridos conforme necessário. Em condições de erro (por exemplo, se o layout da partição for alterado), o GRUB poderá falhar na inicialização. Quando isso acontece, um shell de comando pode aparecer.

O GRUB oferece vários shells/prompts. Se houver um problema ao ler o menu, mas o gerenciador de inicialização conseguir localizar o disco, você provavelmente será descartado no shell "normal":

grub>

Se houver um problema mais sério (por exemplo, o GRUB não conseguir localizar os arquivos necessários), você poderá ser direcionado para o shell "rescue":

grub rescue>

O shell de recuperação é um subconjunto restrito do shell normal, oferecendo muito menos funcionalidade. Se for jogado no shell de recuperação, primeiro tente inserir o módulo "normal" e, em seguida, inicie o shell "normal":

grub rescue> set prefix=(hdX,Y)/boot/grub
grub rescue> insmod (hdX,Y)/boot/grub/i386-pc/normal.mod
rescue:grub> normal

Suporte a paginador

O GRUB possui suporte a paginador para ler comandos que fornecem saída longa (como o comando ). Isso funciona apenas no modo shell normal e não no modo de recuperação. Para digitar o paginador, digite no shell de comando do GRUB:

sh:grub> set pager=1

Usando o ambiente shell de comandos para iniciar sistemas operacionais

grub>

O ambiente de shell de comando do GRUB pode ser usado para inicializar sistemas operacionais. Um cenário comum pode ser inicializar o Windows/Linux armazenado em uma unidade/partição via carregamento em cadeia (chainloading).

Chainloading significa carregar outro carregador de boot a partir do atual, isto é, carregamento em cadeia.

O outro gerenciador de boot pode ser incorporado no início de um disco particionado (MBR), no início de uma partição ou em um disco sem partição (VBR) ou como um binário EFI no caso de UEFI.

Carregando o VBR de uma partição

set root=(hdX,Y)
chainloader +1
boot

X=0,1,2... Y=1,2,3...

Por exemplo, para carregar o Windows armazenado na primeira partição do primeiro disco rígido,

set root=(hd0,1)
chainloader +1
boot

Da mesma forma, o GRUB instalado em uma partição pode ser carregado em cadeia.

Carregando o MBR de um disco ou o VBR de um disco sem partição

set root=hdX
chainloader +1
boot

Carregando Windows/Linux instalado em modo UEFI

insmod fat
set root=(hd0,gpt4)
chainloader (${root})/EFI/Microsoft/Boot/bootmgfw.efi
boot

é usado para carregar o módulo do sistema de arquivos FAT para acessar o gerenciador de boot do Windows na partição do sistema EFI.

(hd0,gpt4) ou é a partição do sistema EFI neste exemplo. A entrada na linha especifica o caminho do arquivo .efi a ser carregado em cadeia.

Carregamento normal

Veja os exemplos em #Usando o console de recuperação

Usando o console de recuperação

Veja #Usando o shell de comandos primeiro. Se não for possível ativar o shell padrão, uma solução possível é inicializar usando um live CD ou algum outro disco de recuperação para corrigir erros de configuração e reinstalar o GRUB. No entanto, esse disco de inicialização nem sempre está disponível (nem necessário); o console de recuperação é surpreendentemente robusto.

Os comandos disponíveis na recuperação do GRUB incluem insmod, , e . Este exemplo usa e insmod. modifica variáveis e insmod insere novos módulos para adicionar funcionalidade.

Antes de iniciar, o usuário deve saber a localização de sua partição (seja uma partição separada ou um subdiretório sob sua raiz):

grub rescue> set prefix=(hdX,Y)/boot/grub

sendo o número da unidade física e o número da partição.

Para expandir as capacidades do console, insira o módulo :

grub rescue> insmod i386-pc/linux.mod

ou simplesmente

grub rescue> insmod linux

Isso introduz os comandos e initrd, que devem ser familiares.

Um exemplo, inicializando o Arch Linux:

set root=(hd0,5)
linux /boot/vmlinuz-linux root=/dev/sda5
initrd /boot/initramfs-linux.img
boot

Com uma partição de inicialização separada (por exemplo, ao usar UEFI), altere as linhas novamente:

set root=(hd0,5)
linux (hdX,Y)/vmlinuz-linux root=/dev/sda6
initrd (hdX,Y)/initramfs-linux.img
boot

Após inicializar com êxito a instalação do Arch Linux, os usuários podem corrigir o conforme necessário e reinstalar o GRUB.

Para reinstalar o GRUB e corrigir o problema completamente, altere , se necessário. Veja #Instalação para detalhes.

Remoção do GRUB

Em geral, para remover o grub, deve-se fazer as etapas de instalação na ordem inversa. Talvez limpando qualquer sobra no final. No entanto, antes de fazer qualquer coisa, é preciso decidir se e como a máquina inicializará após a remoção. Supondo que alguém remova o grub porque gostaria de usar outro carregador de inicialização, um método seguro, embora um pouco difícil, é certificar-se de que o outro gerenciador de boot está funcionando antes de remover o grub.

De qualquer forma, mesmo ao remover o grub antes de instalar outro gerenciador de boot, para o caso UEFI, execute:

$ efibootmgr

E verifique se o outro gerenciador de boot está listado na linha . Se o grub não foi removido, o outro gerenciador de boot deve ser listado antes de grub. Se grub já foi removido, grub não deve ser mencionado nessa linha. Mas observe que esta é apenas uma condição necessária, mas não suficiente, para que a máquina inicialize com o outro gerenciador de boot. Nem é uma condição suficiente para a remoção completa do grub.

Para máquinas UEFI e não UEFI, grub-install foi executado manualmente como parte da instalação do grub. Um de seus trabalhos para o caso UEFI foi executar o equivalente a efibootmgr --create. Como parte da remoção do grub, deve-se remover os produtos de grub-install. O oposto de efibootmgr --create é , ou um programa equivalente. Uma maneira de obter o número da entrada de inicialização para o comando é a partir da saída de (sem argumentos).

grub-install cria o diretório que precisa ser removido manualmente. Embora alguns usuários queiram mantê-lo, caso queiram instalar o grub novamente.

Após migrar para o GPT/UEFI, pode-se querer remover o código de inicialização do MBR usando dd:

# dd if=/dev/zero of=/dev/sdX bs=440 count=1

Solução de problemas

Sistemas de arquivos sem suporte

No caso do GRUB não possuir suporte ao sistema de arquivos raiz, uma partição alternativa com um sistema de arquivos compatível deve ser criada. Em alguns casos, a versão de desenvolvimento do GRUB pode ter suporte nativo para o sistema de arquivos.

Se o GRUB é usado com um sistema de arquivos incompatível, ele não é capaz de extrair o UUID da sua unidade, então ele usa nomes clássicos não-persistentes . Nesse caso, você pode ter que editar manualmente e substituir root=/dev/sdXx com . Você pode usar o comando para obter o UUID do seu dispositivo, consulte Nomeação persistente de dispositivo de bloco.

Embora o GRUB ofereça suporte a F2FS desde a versão 2.0.4, ele não pode ler corretamente seus arquivos de inicialização de uma partição F2FS que foi criada com o sinalizador ativado.

Habilitar mensagens de depuração

Adicionar:

set pager=1
set debug=all

para .

Mensagem de erro sobre estilo msdos

grub-setup: warn: Este rótulo de partição estilo msdos não tem espaço vago pós-MBR; não será possível embuti-lo!
grub-setup: warn: Incorporação não permitida. O GRUB só pode ser instalado neste setup usando blocklists.
            Porém. blocklists são INSTÁVEIS e seu uso não é aconselhado.
grub-setup: error: If you really want blocklists, use --force.

Este erro pode ocorrer quando você tenta instalar o GRUB em um contêiner VMware. Leia mais sobre isso aqui. Isso acontece quando a primeira partição começa logo após o MBR (bloco 63), sem o espaço usual de 1 MiB (2048 blocos) antes da primeira partição. Leia #Instruções específicas de Master Boot Record (MBR).

Erros comuns de instalação

• Se você tiver um problema ao executar o grub-install com sysfs ou procfs e ele disser que você deve executar , tente Unified Extensible Firmware Interface#Mount efivarfs.
• Sem a opção ou --directory, o grub-install não pode determinar qual firmware deve ser instalado. Em tais casos, grub-install irá imprimir .
• Se, depois de executar o grub-install, for informado que sua partição não se parece com uma partição EFI, a partição provavelmente não é .

Criar uma entrada do GRUB no gerenciador de boot do firmware

grub-install automaticamente tenta criar uma entrada no gerenciador de boot. Se não conseguir, então veja UEFI#efibootmgr para instruções de como usar o para criar uma entrada. No entanto, o problema possivelmente é devido a não ter inicializado o seu CD/USB no modo UEFI, como descrito em UEFI#Create UEFI bootable USB from ISO.

Como outro exemplo de criação de uma entrada GRUB no gerenciador de boot do firmware, considere efibootmgr -c. Isso pressupõe que /dev/sda1 é a partição de sistema EFI e está montada em /boot/efi. Quais são o comportamento padrão de . Ele cria uma nova opção de inicialização chamada "Linux" e a coloca no topo da lista de ordem de inicialização. Opções podem ser passadas para modificar o comportamento padrão. O carregador de sistema operacional padrão é \EFI\arch\grub.efi.

Descartar o shell de recuperação

Se o GRUB for carregado, mas cair no shell de recuperação sem erros, pode ser devido a um destes dois motivos:

• Pode ser por causa de um ausente ou extraviado. Isso acontecerá se o UEFI do GRUB tiver sido instalado com e estiver faltando,
• Isso também acontece se a partição de inicialização, que é codificada no arquivo , for alterada.

UEFI do GRUB não carregado

Um exemplo de um UEFI funcional:

Se a tela ficar preta por um segundo e a próxima opção de inicialização for tentada posteriormente, de acordo com esta publicação, mova o GRUB para a raiz da partição pode ajudar. A opção de inicialização deve ser excluída e recriada posteriormente. A entrada para o GRUB deve ficar assim:

Boot0000* GRUB HD(1,800,32000,23532fbb-1bfa-4e46-851a-b494bfe9478c)File(\grubx64.efi)

Caminho de inicialização padrão/reserva

Alguns firmwares UEFI exigem um arquivo inicializável em um local conhecido antes de mostrar as entradas de inicialização da UEFI NVRAM. Se este for o caso, grub-install irá reivindicar que adicionou uma entrada para inicializar o GRUB, no entanto a entrada não será mostrada no seletor de ordem de inicialização do VisualBIOS. A solução é instalar o GRUB no caminho de inicialização padrão/reserva:

# grub-install --target=x86_64-efi --efi-directory=esp --removable

Alternativamente, você pode mover um executável do GRUB EFI já instalado para o caminho padrão/reserva:

# mv esp/EFI/grub esp/EFI/BOOT
# mv esp/EFI/BOOT/grubx64.efi esp/EFI/BOOT/BOOTX64.EFI

Assinatura inválida

Se tentar inicializar o Windows, resulta em um erro de "assinatura inválida", por exemplo, depois de reconfigurar partições ou adicionar discos rígidos adicionais, (re)mova a configuração do dispositivo do GRUB e reconfigure:

# mv /boot/grub/device.map /boot/grub/device.map-old
# grub-mkconfig -o /boot/grub/grub.cfg

agora deve mencionar todas as opções de inicialização encontradas, incluindo o Windows. Se funcionar, remova .

Inicialização congelando

Se a inicialização for travada sem nenhuma mensagem de erro após o GRUB carregar o kernel e o disco em memória inicial, tente remover o parâmetro do kernel .

Arch não encontrado por outros sistemas operacionais

Algumas pessoas relataram que outras distribuições podem ter problemas para encontrar o Arch Linux automaticamente com . Se esse problema ocorrer, foi relatado que a detecção pode ser melhorada com a presença de . Esta ferramenta de arquivo e atualização está disponível com o pacote lsb-release.

Aviso ao instalar em chroot

Ao instalar o GRUB em um sistema LVM em um ambiente chroot (por exemplo, durante a instalação do sistema), você pode receber avisos como

/run/lvm/lvmetad.socket: connect failed: No such file or directory

ou

WARNING: failed to connect to lvmetad: No such file or directory. Falling back to internal scanning.

Isto é porque não está disponível dentro do chroot. Esses avisos não impedem o sistema de inicializar, desde que tudo tenha sido feito corretamente, assim você pode continuar com a instalação.

GRUB carrega lentamente

O GRUB pode levar muito tempo para carregar quando o espaço em disco está baixo. Verifique se você tem espaço livre em disco suficiente em sua partição ou quando tiver problemas.

erro: sistema de arquivos desconhecido

O GRUB pode emitir e se recusar a inicializar por alguns motivos. Se você tem certeza de que todos os UUIDs estão corretos e todos os sistemas de arquivos são válidos e compatíveis, pode ser que sua partição de inicialização de BIOS esteja localizada fora dos primeiros 2 TiB da unidade . Use uma ferramenta de particionamento de sua escolha para garantir que essa partição esteja totalmente localizada nos primeiros 2 TiB, depois reinstale e reconfigure o GRUB.

Esse erro também pode ser causado por um sistema de arquivos ext4 tem um conjuto de recursos sem suporte:

• large_dir -- sem suporte.
• -- terá suporte no GRUB 2.11 (commit).

grub-reboot não está redefinido

O GRUB parece não conseguir gravar em partições BTRFS de raiz . Se você usar o grub-reboot para inicializar em outra entrada, será incapaz de atualizar seu ambiente em disco. Execute o grub-reboot a partir da outra entrada (por exemplo, ao alternar entre várias distribuições) ou considere um sistema de arquivos diferente. Você pode redefinir uma entrada "sticky" executando e configurando no /etc/default/grub (não esqueça ).

BTRFS antigo impede a instalação

Se uma unidade estiver formatada com o BTRFS sem criar uma tabela de partição (por exemplo, ), mais tarde será gravada a tabela de partições, existindo partes do formato BTRFS que persistem. A maioria dos utilitários e sistemas operacionais não vê isso, mas o GRUB se recusará a instalar, mesmo com --force.

# grub-install: warning: Attempting to install GRUB to a disk with multiple partition labels. This is not supported yet.
# grub-install: error: filesystem `btrfs' does not support blocklists.

Você pode zerar a unidade, mas a solução fácil que deixa seus dados sozinhos é apagar o superbloco BTRFS com .

Windows 8/10 não encontrado

Uma configuração no Windows 8/10 chamada "Hiberboot", "Hybrid Boot" or "Fast Boot" (inicialização rápida pode impedir que a partição do Windows seja montada, portanto, o não localizará uma instalação do Windows. Desativar o Hiberboot no Windows permitirá que ele seja adicionado ao menu GRUB.

Modo EFI no VirtualBox

Para VirtualBox < 6.1, instale o GRUB para o caminho de inicialização padrão/reserva.

Veja também VirtualBox (Português)#Instalação no modo EFI no VirtualBox < 6.1.

Recuperação do GRUB e /boot criptografado

Ao usar um /boot criptografado e você não conseguir inserir uma senha correta, você será jogado no prompt de recuperação do GRUB.

Este prompt de recuperação do grub tem capacidades limitadas. Use os seguintes comandos para completar a inicialização:

Veja esta publicação de blog para uma descrição melhor.

GRUB está instalado, mas o menu não é mostrado na inicialização

Verifique /etc/default/grub se está definido como e, caso esteja, defina-o com um número positivo: ele define o número de segundos antes da entrada padrão do GRUB ser carregada. Verifique também se está definido como e defina como menu, para que o menu seja exibido por padrão. Então gere novamente o arquivo principal e reinicie para verificar se funcionou.

Veja também

• Wikipedia:GNU GRUB
• Manual oficial do GRUB
• Página wiki do Ubuntu sobre GRUB
• Página wiki sobre GRUB descrevendo passos para compilar para sistemas UEFI
• Wikipedia:BIOS Boot partition
• Como configurar o GRUB
• Detectando arquivos efi e iniciando-os a partir do grub