remove empty line between heading and attribute definition, fix man titles
[pve-docs.git] / pve-usbstick.adoc
1 Install from USB Stick
2 ----------------------
3 include::attributes.txt[]
4 ifdef::wiki[]
5 :pve-toplevel:
6 endif::wiki[]
7
8 The {pve} installation media is now a hybrid ISO image, working in two
9 ways:
10
11 * An ISO image file ready to burn on CD
12
13 * A raw sector (IMG) image file ready to directly copy to flash media
14   (USB Stick)
15
16 Using USB sticks is faster and more environmental friendly and
17 therefore the recommended way to install {pve}.
18
19
20 Prepare a USB flash drive as install medium
21 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
22
23 In order to boot the installation media, copy the ISO image to a USB
24 media.
25
26 First download the ISO image from
27 https://www.proxmox.com/en/downloads/category/iso-images-pve
28
29 You need at least a 1 GB USB media.
30
31 NOTE: Using UNetbootin or Rufus does not work.
32
33 IMPORTANT: Make sure that the USB media is not mounted and does not
34 contain any important data.
35
36
37 Instructions for GNU/Linux
38 ~~~~~~~~~~~~~~~~~~~~~~~~~~
39
40 You can simply use `dd` on UNUX like systems. First download the ISO
41 image, then plug in the USB stick. You need to find out what device
42 name gets assigned to the USB stick (see below). Then run:
43
44 ----
45 dd if=proxmox-ve_*.iso of=/dev/XYZ bs=1M
46 ----
47
48 NOTE: Be sure to replace /dev/XYZ with the correct device name.
49
50 CAUTION: Be very careful, and do not overwrite the hard disk!
51
52
53 Find Correct USB Device Name
54 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
55
56 You can compare the last lines of 'dmesg' command before and after the
57 insertion, or use the 'lsblk' command. Open a terminal and run:
58
59 ----
60  lsblk
61 ----
62
63 Then plug in your USB media and run the command again:
64
65 ----
66  lsblk
67 ----
68
69 A new device will appear, and this is the USB device you want to use.
70
71
72 Instructions for OSX
73 ~~~~~~~~~~~~~~~~~~~~
74
75 Open the terminal (query Terminal in Spotlight).
76
77 Convert the .iso file to .img using the convert option of hdiutil for example.
78
79 ----
80 hdiutil convert -format UDRW -o proxmox-ve_*.dmg proxmox-ve_*.iso
81 ----
82
83 TIP: OS X tends to put the .dmg ending on the output file automatically.
84
85 To get the current list of devices run the command again:
86
87 ----
88 diskutil list
89 ----
90
91 Now insert your USB flash media and run this command again to
92 determine the device node assigned to your flash media
93 (e.g. /dev/diskX).
94
95 ----
96 diskutil list
97
98 diskutil unmountDisk /dev/diskX
99 ----
100
101 NOTE: replace X with the disk number from the last command.
102
103 ----
104 sudo dd if=proxmox-ve_*.dmg of=/dev/rdiskN bs=1m
105 ----
106
107
108 Instructions for Windows
109 ~~~~~~~~~~~~~~~~~~~~~~~~
110
111 In order to copy the ISO, rename it first. Just rename the downloaded
112 file from proxmox-ve_*.iso to proxmox-ve_*.raw.
113
114 Download the SUSE Studio ImageWriter from https://en.opensuse.org/SDB:Live_USB_stick
115
116 If this doesn't work, alternative use the OSForsenics USB
117 installer from http://www.osforensics.com/portability.html
118
119
120 Boot your server from USB media
121 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
122
123 Connect your USB media to your server and make sure that the server
124 boots from USB (see server BIOS). Then follow the installation wizard.