1"use strict";(self.webpackChunksolus_help_center=self.webpackChunksolus_help_center||[]).push([["5973"],{55023(e,t,n){n.r(t),n.d(t,{metadata:()=>s,default:()=>u,frontMatter:()=>r,contentTitle:()=>l,toc:()=>c,assets:()=>i});var s=JSON.parse('{"id":"user/quick-start/boot-management","title":"Boot management","description":"Solus uses clr-boot-manager from the Clear Linux project to handle all boot configuration. This tool automatically configures the appropriate boot loader based on your system type:","source":"@site/docs/user/quick-start/boot-management.md","sourceDirName":"user/quick-start","slug":"/user/quick-start/boot-management","permalink":"/docs/user/quick-start/boot-management","draft":false,"unlisted":false,"editUrl":"https://github.com/getsolus/help-center-docs/tree/master/docs/user/quick-start/boot-management.md","tags":[],"version":"current","lastUpdatedAt":1765591063000,"frontMatter":{"title":"Boot management","summary":"Guide to customizing the Solus boot process"},"sidebar":"userSidebar","previous":{"title":"Quick Start","permalink":"/docs/category/quick-start"},"next":{"title":"Default Applications","permalink":"/docs/user/quick-start/default-applications"}}'),o=n(74848),a=n(28453);let r={title:"Boot management",summary:"Guide to customizing the Solus boot process"},l,i={},c=[{value:"Access the boot menu",id:"access-the-boot-menu",level:2},{value:"Display the boot menu by default",id:"display-the-boot-menu-by-default",level:2},{value:"Add kernel parameters",id:"add-kernel-parameters",level:2}];function d(e){let t={code:"code",h2:"h2",li:"li",ol:"ol",p:"p",pre:"pre",ul:"ul",...(0,a.R)(),...e.components};return(0,o.jsxs)(o.Fragment,{children:[(0,o.jsxs)(t.p,{children:["Solus uses ",(0,o.jsx)(t.code,{children:"clr-boot-manager"})," from the Clear Linux project to handle all boot configuration. This tool automatically configures the appropriate boot loader based on your system type:"]}),"\n",(0,o.jsxs)(t.ul,{children:["\n",(0,o.jsx)(t.li,{children:"Legacy BIOS systems: GRUB2"}),"\n",(0,o.jsxs)(t.li,{children:["Modern UEFI systems: ",(0,o.jsx)(t.code,{children:"systemd-boot"})]}),"\n"]}),"\n",(0,o.jsxs)(t.p,{children:["Because ",(0,o.jsx)(t.code,{children:"clr-boot-manager"})," manages these configurations, any boot customizations must go through this tool rather than manual edits. If you try to modify the configurations manually, ",(0,o.jsx)(t.code,{children:"clr-boot-manager"})," will overwrite your changes during the next system update."]}),"\n",(0,o.jsx)(t.h2,{id:"access-the-boot-menu",children:"Access the boot menu"}),"\n",(0,o.jsx)(t.p,{children:"On systems with UEFI installations, the boot menu doesn't appear by default. To display the boot menu:"}),"\n",(0,o.jsxs)(t.ul,{children:["\n",(0,o.jsxs)(t.li,{children:["Press the ",(0,o.jsx)("kbd",{children:"Space bar"})," key repeatedly as your computer starts. You may need several attempts to get the timing right."]}),"\n"]}),"\n",(0,o.jsx)(t.h2,{id:"display-the-boot-menu-by-default",children:"Display the boot menu by default"}),"\n",(0,o.jsx)(t.p,{children:"To make the boot menu appear automatically with a five-second timeout:"}),"\n",(0,o.jsxs)(t.ul,{children:["\n",(0,o.jsxs)(t.li,{children:["\n",(0,o.jsx)(t.p,{children:"Run the following command:"}),"\n",(0,o.jsx)(t.pre,{children:(0,o.jsx)(t.code,{className:"language-bash",children:"sudo clr-boot-manager set-timeout 5 && sudo clr-boot-manager update\n"})}),"\n"]}),"\n"]}),"\n",(0,o.jsx)(t.h2,{id:"add-kernel-parameters",children:"Add kernel parameters"}),"\n",(0,o.jsxs)(t.p,{children:["You can add kernel parameters by creating configuration files that ",(0,o.jsx)(t.code,{children:"clr-boot-manager"})," uses when updating kernels."]}),"\n",(0,o.jsx)(t.p,{children:"To add kernel parameters, do the following:"}),"\n",(0,o.jsxs)(t.ol,{children:["\n",(0,o.jsxs)(t.li,{children:["\n",(0,o.jsx)(t.p,{children:"Create the configuration directory:"}),"\n",(0,o.jsx)(t.pre,{children:(0,o.jsx)(t.code,{className:"language-bash",children:"sudo mkdir -p /etc/kernel/cmdline.d\n"})}),"\n"]}),"\n",(0,o.jsxs)(t.li,{children:["\n",(0,o.jsx)(t.p,{children:"Create a configuration file with your kernel parameter:"}),"\n",(0,o.jsx)(t.pre,{children:(0,o.jsx)(t.code,{className:"language-bash",children:"echo 'parameter-name' | sudo tee /etc/kernel/cmdline.d/40_[description].conf\n"})}),"\n",(0,o.jsxs)(t.p,{children:["For example, to add the ",(0,o.jsx)(t.code,{children:"nomodeset"})," parameter:"]}),"\n",(0,o.jsx)(t.pre,{children:(0,o.jsx)(t.code,{className:"language-bash",children:"echo 'nomodeset' | sudo tee /etc/kernel/cmdline.d/40_nomodeset.conf\n"})}),"\n"]}),"\n",(0,o.jsxs)(t.li,{children:["\n",(0,o.jsx)(t.p,{children:"If you want to add multiple parameters, put them on one line with spaces between them in the configuration file."}),"\n",(0,o.jsx)(t.p,{children:"For example:"}),"\n",(0,o.jsx)(t.pre,{children:(0,o.jsx)(t.code,{className:"language-bash",children:"echo 'nomodeset quiet splash acpi=off' | sudo tee /etc/kernel/cmdline.d/40_multiple_params.conf\n"})}),"\n"]}),"\n",(0,o.jsxs)(t.li,{children:["\n",(0,o.jsx)(t.p,{children:"Apply the new kernel parameters:"}),"\n",(0,o.jsx)(t.pre,{children:(0,o.jsx)(t.code,{className:"language-bash",children:"sudo clr-boot-manager update\n"})}),"\n"]}),"\n"]})]})}function u(e={}){let{wrapper:t}={...(0,a.R)(),...e.components};return t?(0,o.jsx)(t,{...e,children:(0,o.jsx)(d,{...e})}):d(e)}},28453(e,t,n){n.d(t,{R:()=>r,x:()=>l});var s=n(96540);let o={},a=s.createContext(o);function r(e){let t=s.useContext(a);return s.useMemo(function(){return"function"==typeof e?e(t):{...t,...e}},[t,e])}function l(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(o):e.components||o:r(e.components),s.createElement(a.Provider,{value:t},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.