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

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

sajolida's avatar
sajolida committed
6
7
8
9
10
11
You can use the Boot Loader to add *boot options*. Boot options are
special parameters that can be useful to troubleshoot or workaround
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
31
32
33
34
35
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*
================

This is how *SYSLINUX* looks like:

[[!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
38
39
40
41
<div class="note">

<p>If your Boot Loader looks differently, refer to our instructions on
adding a boot option [[using GRUB|boot_options#grub]] below.</p>

</div>
42
43
44

To add a boot option in *SYSLINUX*:

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

47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
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"]]

2. Press <span class="keycap">Space</span> and type the boot option that you
   want to add.

3. If you want to add more than one boot option, type them one after the
   other and separate them by a <span class="keycap">Space</span>.

4. Press <span class="keycap">Enter</span> to start Tails.

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

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

This is how GRUB looks like:

[[!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
73
74
75
76
77
78
<div class="note">

<p>If your Boot Loader looks differently, refer to our instructions on
adding a boot option [[using SYSLINUX|boot_options#syslinux]] above.</p>

</div>
79
80
81

To add a boot option in *GRUB*:

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

84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
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'"]]

1. Navigate with the arrows of the keyboard to the end of the line that
   starts with <span class="code">linux</span>. The line is most likely
   wrapped and displayed on several lines on the screen but it is a
   single configuration line.

1. Type the boot option that you want to add.

1. If you want to add more than one boot option, type them one after the
   other and separate them by a <span class="keycap">Space</span>.

1. Press **Ctrl+X** to start Tails.