---
title: Configuração do Gestor de Arranque
description: Configure as definições do gestor de arranque e passe parâmetros do kernel para a linha de comandos
ai_translated: true
---

## systemd-boot

O systemd-boot possui dois tipos de ficheiros de configuração: um para o próprio systemd-boot em `/boot/loader/loader.conf`, e um para cada entrada individual do kernel em `/boot/loader/entry`.

### Configuração do Loader (Carregador)

Neste ficheiro de configuração, pode alterar a entrada padrão e o tempo de espera (timeout) do systemd-boot.

```shell
# /boot/loader/loader.conf

default @saved
timeout 5
#console-mode keep # This option configures the resolution of the console.
```

### Configuração da Linha de Comandos do Kernel

Disponibilizamos uma ferramenta para facilitar a configuração do systemd-boot: o [`sdboot-manage`](https://github.com/CachyOS/CachyOS-PKGBUILDS/tree/master/systemd-boot-manager).
Uma das vantagens desta ferramenta é a configuração global da linha de comandos do kernel. O ficheiro de configuração do `sdboot-manage` está localizado em `/etc/sdboot-manage.conf`.

Edite a linha `LINUX_OPTIONS=` em `/etc/sdboot-manage.conf` para alterar os parâmetros do kernel.

```shell
# /etc/sdboot-manage.conf
LINUX_OPTIONS="zswap.enabled=0 nowatchdog quiet splash"
```

Após efetuar as alterações, regenere todas as entradas do systemd-boot com o seguinte comando:

```shell
sudo sdboot-manage gen
```

## rEFInd

Tal como o [systemd-boot](/pt/configuration/boot_manager_configuration#systemd-boot), o rEFInd possui dois ficheiros de configuração. O `refind.conf`, localizado em `/boot/efi/EFI/refind`, serve principalmente para alterar o comportamento do rEFInd, enquanto o `/boot/refind_linux.conf` serve para gerir as suas opções de arranque. O `refind.conf` contém comentários extensos que explicam todas as suas opções.

### Configuração da Linha de Comandos do Kernel

Para passar parâmetros do kernel para a linha de comandos, modifique a secção "Boot using default options" em `/boot/refind_linux.conf`

```shell
# /boot/refind_linux.conf

"Boot using default options"     "root=PARTUUID=1cb353ec-7f03-4820-8b4b-03baf53a208f rw zswap.enabled=0 nowatchdog quiet splash"
```

As alterações em ambos os ficheiros de configuração terão efeito imediato. Não é necessário executar um comando para "guardar" as alterações.

## GRUB

Ao contrário do [systemd-boot](/pt/configuration/boot_manager_configuration#systemd-boot) e do [rEFInd](/pt/configuration/boot_manager_configuration#refind), o GRUB possui apenas um ficheiro de configuração localizado em `/etc/default/grub`. Existe documentação bastante boa dentro deste ficheiro que explica o que cada opção faz.

### Ocultar o Menu de Arranque do GRUB

Para ocultar o menu do GRUB, basta definir as seguintes opções de acordo:

```shell
# /etc/default/grub

GRUB_TIMEOUT='0'
GRUB_TIMEOUT_STYLE=hidden
```

Prima ESC para aceder à linha de comandos (prompt) do GRUB. A partir daqui, execute `normal` ou `exit` para regressar ao menu de arranque familiar do GRUB.

### Configuração da Linha de Comandos do Kernel

Para passar parâmetros do kernel para a linha de comandos com o GRUB, precisamos de editar a variável `GRUB_CMDLINE_LINUX_DEFAULT` dentro de `/etc/default/grub`.

```shell
# /etc/default/grub

GRUB_CMDLINE_LINUX_DEFAULT='nowatchdog zswap.enabled=0 quiet splash'
```

Sempre que modificarmos o ficheiro de configuração do GRUB, precisamos de gerar novamente a configuração com o seguinte comando:

```shell
sudo grub-mkconfig -o /boot/grub/grub.cfg
```

### Snapshots BTRFS Arrancáveis

:::note
Se a sua instalação do CachyOS for anterior à versão de agosto, poderá ter de ativar manualmente a funcionalidade de snapshots BTRFS arrancáveis.

Caso contrário, pode saltar esta secção, uma vez que esta funcionalidade está ativada por defeito desde a versão de agosto.
:::

Para ativar a funcionalidade, instale o pacote `grub-btrfs-support`:

```sh
sudo pacman -S grub-btrfs-support
```

Este pacote instala os scripts e *hooks* necessários para detetar automaticamente os *snapshots* BTRFS e adicioná-los ao menu do GRUB.

Uma vez instalado, os seus *snapshots* aparecerão no menu do GRUB, de forma semelhante ao comportamento do Limine.

## Limine

O Limine é um gestor de arranque (*bootloader*) moderno, conhecido pela sua configuração simples. Este guia abrange o essencial para começar.

A configuração ocorre principalmente em `/boot/limine.conf` (ou, por vezes, na partição de sistema EFI) para as definições do menu, e em `/etc/default/limine` para os parâmetros do kernel.

### Configuração do Menu de Arranque

Este ficheiro controla o comportamento e a aparência do menu de arranque. As alterações feitas aqui entram em vigor imediatamente após guardar — não são necessários comandos adicionais.

* **Timeout:** Define quantos segundos o Limine aguarda antes de iniciar automaticamente a entrada padrão.

  ```shell
  # /boot/limine.conf

  timeout: 5
  ```

* **Entrada Padrão (Default Entry):** Especifica qual a entrada do menu que arranca por defeito. As entradas são numeradas a partir de 1. Se não for definida, o valor padrão é 1.

  ```shell
  # /boot/limine.conf

  default_entry: 2 # Boot the second entry by default
  ```

  :::tip
   Se o `default_entry` apontar para um diretório (ex: `/+CachyOS`), o arranque automático (autoboot) será desativado. Para arrancar automaticamente uma entrada dentro de um diretório, o `default_entry` deve apontar diretamente para o número dessa entrada específica.
  :::

Exemplo (`/boot/limine.conf`):

```shell
# /boot/limine.conf

timeout: 5
default_entry: 2 # Points directly to the 'linux-cachyos' entry below

/+CachyOS        # Entry 1: A directory (use /+ to expand by default)
//linux-cachyos  # Entry 2: The actual bootable entry
    protocol: linux
    kernel_path: boot():/vmlinuz-linux-cachyos
    cmdline: quiet splash root=UUID=... rw # Basic kernel parameters
    module_path: boot():/initramfs-linux-cachyos.img
```

:::note
`boot():/` refere-se à raiz do disco de arranque.
:::

### Personalização (Theming)

Pode personalizar a aparência visual do menu de arranque do Limine:

* **Wallpaper:** Define uma imagem de fundo. Os formatos suportados incluem BMP, PNG e JPEG.

  ```shell
  # /boot/limine.conf

  wallpaper: boot():/splash.png
  wallpaper_style: stretched # Options: 'stretched', 'tiled', 'centered'
  backdrop: 000000           # Background color (RRGGBB hex) if style is 'centered'
  ```

* **Tipos de Letra (Fonts):** Utilize um [ficheiro de fonte personalizado](https://github.com/viler-int10h/vga-text-mode-fonts) e ajuste o seu tamanho.

  ```shell
  # /boot/limine.conf

  term_font: boot():/custom_font.F16
  term_font_scale: 2x2 # Scales font size, useful for high-resolution displays
  ```

* **Cores:** Modifique as cores do texto e do fundo do terminal.

  ```shell
  # /boot/limine.conf

  term_background: 80000000 # Example: Semi-transparent black (AARRGGBB)
  # Estão disponíveis outras opções de cores, como term_foreground, entre outras.
  ```

### Configuração de Comandos do Kernel

No CachyOS, as entradas do kernel no menu de arranque do Limine são **geridas automaticamente**. Quando instala ou remove kernels, o *hook* `limine-mkinitcpio-hook` utiliza a utilidade `limine-entry-tool` em segundo plano para atualizar as entradas de arranque.

Embora as entradas sejam tratadas de forma automática, pode **configurar os parâmetros do kernel** (também conhecidos como linha de comandos do kernel) que são passados ao kernel no momento do arranque.

1. **Editar o ficheiro de configuração:** Modifique as variáveis `KERNEL_CMDLINE` em `/etc/default/limine`. Pode definir parâmetros padrão para todos os kernels ou parâmetros específicos para determinados nomes de kernel (ex: `linux-cachyos`).

   ```shell
   # /etc/default/limine

   # Parâmetros padrão para a maioria dos kernels
   KERNEL_CMDLINE[default]="quiet splash rd.udev.log_priority=3"

   # Parâmetros específicos para o kernel 'linux-cachyos'
   KERNEL_CMDLINE["linux-cachyos"]="quiet splash mitigations=off"

   # Parâmetros para entradas de fallback (se geradas)
   # KERNEL_CMDLINE[fallback]="..."
   ```

2. **Aplicar as alterações:** Após guardar o ficheiro `/etc/default/limine`, precisa de gerar novamente as imagens initramfs e atualizar as entradas do Limine para aplicar os novos parâmetros do kernel. Execute o seguinte comando:

   ```bash
   sudo limine-mkinitcpio
   ```

    Este comando aciona o processo `mkinitcpio`, que inclui o *hook* `limine-mkinitcpio-hook`, garantindo que as suas alterações em `/etc/default/limine` sejam incorporadas nas entradas de arranque em `/boot/limine.conf`.

## Saiba mais

* [Página do manual loader.conf](https://man.archlinux.org/man/loader.conf.5)
* [rEFInd: Configurar o gestor de arranque](https://www.rodsbooks.com/refind/configfile.html)
* [Manual do GRUB: Configuração](https://www.gnu.org/software/grub/manual/grub/grub.html#Configuration)
* [Documentação oficial de configuração do Limine](https://github.com/limine-bootloader/limine/blob/v12.x/CONFIG.md)
* [Projeto limine-entry-tool](https://gitlab.com/Zesko/limine-entry-tool)
