Jump to content

Plymouth

From Official NixOS Wiki
Revision as of 15:56, 2 June 2026 by Ardenet (talk | contribs) (Convert the link into tvar;Add nowrap translation units for code comment's translation)

Plymouth is an application that runs early in the boot process, providing a graphical boot animation, it is used by most desktop-oriented Linux distributions.

Usage

As an example, you can use a boot animation from adi1090x's collection like so:

❄︎ configuration.nix
{ pkgs, ... }: {
  boot = {
    plymouth = {
      enable = true;
      theme = "rings";
      themePackages = with pkgs; [
        # By default we would install all themes
        (adi1090x-plymouth-themes.override {
          selected_themes = [ "rings" ];
        })
      ];
    };

    # Enable "Silent boot"
    consoleLogLevel = 3;
    initrd.verbose = false;
    kernelParams = [
      "quiet"
      "rd.udev.log_level=3"
      "rd.systemd.show_status=auto"
    ];

    # Hide the OS choice for bootloaders.
    # It's still possible to open the bootloader list by pressing any key
    # It will just not appear on screen unless a key is pressed
    loader.timeout = 0;
  };
}

During the graphical boot process, it is possible to switch to text mode and back by pressing the escape key.

If you are using LUKS encryption the password prompt may fall back to text mode. While the default bgrt theme supports graphical password entry, this may not be supported by all themes.