Manual GRUB Boot Menu Entry

Real use case#

Sebagai referensi kasus nyata, saya akan ceritakan masalah yang saya alami. Beberapa waktu lalu, saya meng-install NixOS sebagai “OS secondary” setelah Archlinux (dan Windows) di SSD yang sama. Setelah selesai memasang NixOS, saya ingin memastikan bahwa NixOS tersebut dapat terdaftar sebagai boot entry di GRUB Archlinux, sehingga saya jalankan os-prober. Benar saja, NixOS dapat terdaftar di GRUB Archlinux. TAPI, sayangnya, ketika saya mencoba masuk ke NixOS dari entry tersebut di GRUB, saya “terlempar” ke Archlinux. Dengan kata lain, entry NixOS yang terdaftar di GRUB tersebut tidak benar-benar menyertakan file bootloader-nya sehingga saya tidak bisa masuk (login).

Setelah mencari tahu penyebabnya, saya menemukan fakta bahwa os-prober memang “ngaco” karena tidak bisa mendeteksi kernel/initrd/root NixOS yang memang “dinamis” bergantung generation-nya di systemd-boot bootloader. Jadi, salah satu solusi yang paling “waras” adalah dengan meng-input-kan secara manual file EFI-nya ke konfigurasi GRUB.

How GRUB config works#

Sebelum memulai, kita perlu tahu cara kerja konfigurasi GRUB ketika kita menjalankan grub-mkconfig.
Berikut adalah isi direktori /etc/grub.d/ saya di Archlinux:

1
Permissions Size User Date Modified Name
2
.rwxr-xr-x  9.8k root 15 Jan 16:03  󰡯 00_header
3
.rwxr-xr-x   13k root 15 Jan 16:03  󰡯 10_linux
4
.rwxr-xr-x   14k root 15 Jan 16:03  󰡯 20_linux_xen
5
.rwxr-xr-x   786 root 15 Jan 16:03  󰡯 25_bli
6
.rwxr-xr-x   13k root 15 Jan 16:03  󰡯 30_os-prober
7
.rwxr-xr-x  1.2k root 15 Jan 16:03  󰡯 30_uefi-firmware
8
.rwxr-xr-x   556 root 26 Sep 18:31  󰡯 40_custom
9
.rwxr-xr-x   215 root 15 Jan 16:03  󰡯 41_custom
10
.rw-r--r--   483 root 15 Jan 16:03  󰂺 README

Ketika file konfigurasi GRUB di-generate dengan perintah grub-mkconfig, yang terjadi:

1. grub-mkconfig menjalankan semua script executable di /etc/grub.d/ tersebut sesuai urutan angka prefix-nya (00_header, 10_linux, dst).
2. Tiap script akan men-generate “potongan konfigurasi” masing-masing yang kemudian digabungkan menjadi satu di grub.cfg.

Perhatikan 3 file script ini:

• 10_linux: mendeteksi kernel yang ter-install di sistem lokal.
• 30_os-prober: mendeteksi OS lain di partisi/disk lain (kalau paket os-prober ter-install dan diaktifkan).
• 40_custom: bukan script, tapi komentar placeholder (tempat kosong) untuk memasukkan entry sendiri secara manual (misalnya chainload ke OS lain, boot ISO, kernel custom, atau entry apapun yang mau ditulis manual).

How to manually input GRUB custom entry#

Sekarang, setelah mengetahui cara kerja GRUB dalam men-generate konfigurasinya, kita tahu dimana kita akan membuat entry secara manual: /etc/grub.d/40_custom.

1
#!/bin/sh
2
exec tail -n +3 $0
3
# This file provides an easy way to add custom menu entries.  Simply type the
4
# menu entries you want to add after this comment.  Be careful not to change
5
# the 'exec tail' line above.

1
menuentry "Label" {
2
    insmod part_gpt
3
    insmod fat
4
    search --no-floppy --fs-uuid --set=root UUID
5
    chainloader /path/to/bootloader.efi
6
}

Untuk meng-input-kan entry baru, kita bisa menggunakan perintah berikut:
(Misalnya, saya akan meng-input-kan NixOS)

1
sudo tee -a /etc/grub.d/40_custom > /dev/null << 'EOF'
2

3
menuentry "NixOS (systemd-boot)" {
4
    insmod part_gpt
5
    insmod fat
6
    search --no-floppy --fs-uuid --set=root B071-9102
7
    chainloader /EFI/systemd/systemd-bootx64.efi
8
}
9
EOF

Perintah tersebut akan menambahkan menuentry NixOS tersebut di bagian akhir file 40_custom tanpa me-replace konten yang sudah terlebih dahulu ada. Artinya, jika kalian ingin menambahkan menuentry baru, tinggal gunakan perintah yang sama (tentu dengan mengganti bagian-bagian yang perlu disesuaikan).

Setelah itu jalankan:

1
sudo grub-mkconfig -o /boot/grub/grub.cfg

1
   GRUB_DISABLE_OS_PROBER=false

Kita bisa memverifikasi menuentry-nya dengan perintah:

1
grep -n "menuentry" /boot/grub/grub.cfg

Selesai.

Sebagai tambahan, berikut adalah isi file /etc/grub.d/40_custom saya saat ini:

1
#!/bin/sh
2
exec tail -n +3 $0
3
# This file provides an easy way to add custom menu entries.  Simply type the
4
# menu entries you want to add after this comment.  Be careful not to change
5
# the 'exec tail' line above.
6

7
menuentry "NixOS (systemd-boot)" {
8
    insmod part_gpt
9
    insmod fat
10
    search --no-floppy --fs-uuid --set=root B071-9102
11
    chainloader /EFI/systemd/systemd-bootx64.efi
12
}
13

14
menuentry "Windows 10" {
15
    insmod part_gpt
16
    insmod fat
17
    search --no-floppy --fs-uuid --set=root B071-9102
18
    chainloader /EFI/Microsoft/Boot/bootmgfw.efi
19
}

Saya juga pernah menulis tentang GRUB, terutama terkait kustomisasi tema, aktivasi os-prober, dan beberapa hal lain:

GRUB: Theme, Timeout, OS-Prober, etc

A brief note regarding grub configuration.

2026-03-19grub#grub#theme#timer#os-prober#boot