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