wiki/src/doc/first_steps/installation/manual/linux.mdwn

   1 [[!meta title="Manual installation using Linux"]]
   2
   3 [[!inline pages="doc/first_steps/manual_usb_installation.intro" raw="yes"]]
   4
   5 This technique uses the command line.
   6
   7 [[!toc levels=1]]
   8
   9 <h2 class="bullet-number-one">Install isohybrid</h2>
  10
  11 In **Debian Wheezy**, **Ubuntu 14.04**, and earlier the `isohybrid` utility is
  12 included in the `syslinux` package. To install it, execute the following
  13 command:
  14
  15     sudo apt-get install syslinux
  16
  17 In **Debian Jessie**, **Ubuntu 14.10**, and later the `isohybrid` utility is
  18 included in the `syslinux-utils` package. To install it, execute the following
  19 command:
  20
  21     sudo apt-get install syslinux-utils
  22
  23 <a id="step_2"></a>
  24
  25 <h2 class="bullet-number-two">Find out the device name of the device</h2>
  26
  27 The device name should be something like `/dev/sdb`, `/dev/sdc`, etc.
  28
  29 If you are not sure about the exact device name, with GNOME, do the
  30 following:
  31
  32   1. Make sure that the USB stick or SD card onto which you want to
  33      install Tails is unplugged.
  34
  35   1. Open <span class="application">GNOME Disk Utility</span> from the menu
  36      <span class="menuchoice">
  37        <span class="guimenu">Applications</span>&nbsp;▸
  38        <span class="guisubmenu">Accessories</span>&nbsp;▸
  39        <span class="guimenuitem">Disk Utility</span>
  40      </span>
  41
  42   1. <span class="application">Disk Utility</span> lists all the current storage devices in the
  43      left pane of the window.
  44
  45   1. Plug the USB stick or SD card onto which you want to install Tails.
  46
  47      A new device appears in the list of storage devices. Click on it.
  48
  49   1. In the right pane of the window, verify that the device corresponds
  50      to your device, its brand, its size, etc.
  51
  52      [[!img destination_device_description.png link=no alt="Drive description containing: 'Device: /dev/sdc'"]]
  53
  54      On this screenshot, the USB stick is a Kingston DataTraveler of 2.0
  55      GB and its device name is `/dev/sdc`. Yours are probably different.
  56
  57 <div class="caution">
  58
  59 If you are not sure about the device name, you should stop
  60 proceeding or <strong>you risk overwriting any hard disk on the
  61 system</strong>.
  62
  63 </div>
  64
  65 <a id="step_3"></a>
  66
  67 <h2 class="bullet-number-three">Do the copy</h2>
  68
  69 <div class="caution">
  70
  71 <p><strong>All the data on the installed device will be lost.</strong></p>
  72
  73 </div>
  74
  75 Execute the following commands, replacing `[tails.iso]` with the path
  76 to the ISO image that you want to copy and `[device]` with the device
  77 name found in step 2.
  78
  79 <div class="note">
  80
  81 <p>Note that the <code>isohybrid</code> command modifies the ISO image. As a
  82 consequence, you won't be able to [[verify|download/#verify]] it again
  83 afterwards. We recommend you to execute those commands on a copy of the
  84 original ISO image that you downloaded.</p>
  85
  86 </div>
  87
  88     isohybrid [tails-isohybrid.iso] -h 255 -s 63
  89     dd if=[tails-isohybrid.iso] of=[device] bs=16M
  90
  91 Here is an example of the commands to execute, yours are probably different:
  92
  93     isohybrid '/home/amnesia/Desktop/tails-0.6.2-isohybrid.iso' -h 255 -s 63
  94     dd if='/home/amnesia/Desktop/tails-0.6.2-isohybrid.iso' of=/dev/sdc bs=16M
  95
  96 <div class="tip">
  97
  98 If you are not sure about the path to the ISO image or if you get a
  99 <span class="guilabel">No such
 100 file or directory</span> error message, you can first type
 101 <code>dd</code>, followed by a space, and
 102 then drag and drop the icon of the ISO image from a file browser onto the
 103 terminal. This should insert the correct path to the ISO image in the terminal.
 104 Then complete the command and execute it.
 105
 106 </div>
 107
 108 If you don't see any error message, Tails is being copied
 109 onto the device. The whole process might take some time, generally a few
 110 minutes.
 111
 112 <div class="next">
 113
 114 <p>Once the command prompt reappears, you can shutdown your computer, and
 115 [[start Tails|start_tails]] from this new device.</p>
 116
 117 </div>
 118
 119 Troubleshooting
 120 ===============
 121
 122 ### dd: /dev/sdx: No such file or directory
 123
 124 Then double-check the name of the device you found in [[step
 125 2|linux#step_2]].
 126
 127 ### dd: /dev/sdx: Permission denied
 128
 129 You might also have committed a mistake in the device name, so please
 130 double-check it. If you are sure about the device name, this could be a
 131 permission problem and you could need to gain administration privileges before running the
 132 commands in the terminal. That could be:
 133
 134     isohybrid [tails.iso] -h 255 -s 63
 135     sudo dd if=[tails.iso] of=[device] bs=16M
 136
 137 ### dd: tails.iso: No such file or directory
 138
 139 Then you surely have committed a mistake on the path to the ISO image in [[step
 140 3|linux#step_3]].