boot_options.mdwn 3.22 KB
Newer Older
1
[[!meta title="Modifying the boot options using the Boot Loader"]]
2 3 4 5

The Boot Loader is the first screen that appears
when starting Tails.

6
You can use the Boot Loader to modify the *boot options*. Boot options are
cbrownstein's avatar
cbrownstein committed
7
special parameters that can be useful to troubleshoot or work around
sajolida's avatar
sajolida committed
8 9 10 11
hardware support problems. For example, our [[list of known issues with
graphics cards|support/known_issues/graphics]] document boot options for
different graphics cards.

12 13
<div class="tip">

sajolida's avatar
sajolida committed
14
<p>The <span class="guilabel">Troubleshooting Mode</span> of the Boot Loader disables some features of the
15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
Linux kernel and might work better on some computers. You can try this option if you
think you are experiencing errors related to hardware compatibility while
starting Tails.</p>

</div>

[[!toc levels=1]]

Depending on the computer, the Boot Loader might be either *GRUB* or
*SYSLINUX*.

<a id="syslinux"></a>

Using *SYSLINUX*
================

cbrownstein's avatar
cbrownstein committed
31
This is what *SYSLINUX* looks like:
32 33 34 35

[[!img install/inc/screenshots/syslinux.png link="no" alt="Black screen ('SYSLINUX') with Tails
logo and 2 options: 'Tails' and 'Tails (Troubleshooting Mode)'."]]

sajolida's avatar
sajolida committed
36 37
<div class="note">

cbrownstein's avatar
cbrownstein committed
38
<p>If your Boot Loader looks different, refer to our instructions below on
39
modifying the boot options [[using GRUB|boot_options#grub]].</p>
sajolida's avatar
sajolida committed
40 41

</div>
42

43
To modify the boot options in *SYSLINUX*:
44

45 46
<!-- Keep in sync with install/inc/steps/restart_first_time.inline.mdwn. -->

47 48 49 50 51 52 53 54
1. Press **Tab** when *SYSLINUX* appears.

   A list of boot options
   appears at the bottom of the screen.

   [[!img syslinux-with-options.png link="no" alt="SYSLINUX with
   a list of options starting with '/live/vmlinuz' at the bottom"]]

55 56 57
1. Modify the boot options as needed.

   To add a boot option, press <span class="keycap">Space</span> and type the boot option that you
58 59
   want to add.

60
   If you want to add more than one boot option, type them one after the
cbrownstein's avatar
cbrownstein committed
61
   other and separate them with a <span class="keycap">Space</span>.
62

63
1. Press <span class="keycap">Enter</span> to start Tails.
64 65 66 67 68 69

<a id="grub"></a>

Using *GRUB*
============

cbrownstein's avatar
cbrownstein committed
70
This is what *GRUB* looks like:
71 72 73 74

[[!img install/inc/screenshots/grub.png link="no" alt="Black screen ('GNU GRUB') with Tails
logo and 2 options: 'Tails' and 'Tails (Troubleshooting Mode)'."]]

sajolida's avatar
sajolida committed
75 76
<div class="note">

cbrownstein's avatar
cbrownstein committed
77
<p>If your Boot Loader looks different, refer to our instructions on
78
modifying the boot options [[using SYSLINUX|boot_options#syslinux]] above.</p>
sajolida's avatar
sajolida committed
79 80

</div>
81

82
To modify the boot options in *GRUB*:
83

84 85
<!-- Keep in sync with install/inc/steps/restart_first_time.inline.mdwn. -->

86 87 88 89 90 91 92
1. Press **e** when GRUB appears.

   A new screen appears with more options.

   [[!img grub-with-options.png link="no" alt="GRUB with a list of
   options starting with 'setparams Tails'"]]

93 94 95 96
1. Modify the boot options as needed.

   To add a boot option, navigate with the arrows of the keyboard to the end of the line that
   starts with <span class="code">linux</span> and type the boot option that you want to add. The line is most likely
97 98 99
   wrapped and displayed on several lines on the screen but it is a
   single configuration line.

100
   If you want to add more than one boot option, type them one after the
cbrownstein's avatar
cbrownstein committed
101
   other and separate them with a <span class="keycap">Space</span>.
102

103
1. Press **Ctrl+X**, **F10**, or **Fn+F10** to start Tails.