]>
Commit | Line | Data |
---|---|---|
44ea3fd6 TL |
1 | [[installation_prepare_media]] |
2 | Prepare Installation Media | |
3 | -------------------------- | |
5f09af76 DM |
4 | ifdef::wiki[] |
5 | :pve-toplevel: | |
6 | endif::wiki[] | |
7 | ||
44ea3fd6 TL |
8 | Download the installer ISO image from: {website}en/downloads/category/iso-images-pve |
9 | ||
6d16d741 | 10 | The {pve} installation media is a hybrid ISO image. It works in two ways: |
5c6cf7ac | 11 | |
6d16d741 | 12 | * An ISO image file ready to burn to a CD or DVD. |
5c6cf7ac | 13 | |
6d16d741 | 14 | * A raw sector (IMG) image file ready to copy to a USB flash drive (USB stick). |
5c6cf7ac | 15 | |
6d16d741 AL |
16 | Using a USB flash drive to install {pve} is the recommended way because it is |
17 | the faster option. | |
5c6cf7ac | 18 | |
e40349c6 | 19 | Prepare a USB Flash Drive as Installation Medium |
6d16d741 | 20 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
5c6cf7ac | 21 | |
44ea3fd6 | 22 | The flash drive needs to have at least 1 GB of storage available. |
5c6cf7ac | 23 | |
6d16d741 | 24 | NOTE: Do not use UNetbootin. It does not work with the {pve} installation image. |
5c6cf7ac | 25 | |
6d16d741 | 26 | IMPORTANT: Make sure that the USB flash drive is not mounted and does not |
5c6cf7ac DM |
27 | contain any important data. |
28 | ||
29 | ||
30 | Instructions for GNU/Linux | |
31 | ~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
32 | ||
6d16d741 AL |
33 | On Unix-like operating system use the `dd` command to copy the ISO image to the |
34 | USB flash drive. First find the correct device name of the USB flash drive (see | |
35 | below). Then run the `dd` command. | |
5c6cf7ac DM |
36 | |
37 | ---- | |
8b09f077 | 38 | # dd bs=1M conv=fdatasync if=./proxmox-ve_*.iso of=/dev/XYZ |
5c6cf7ac DM |
39 | ---- |
40 | ||
8b09f077 TL |
41 | NOTE: Be sure to replace /dev/XYZ with the correct device name and adapt the |
42 | input filename ('if') path. | |
5c6cf7ac | 43 | |
6d16d741 | 44 | CAUTION: Be very careful, and do not overwrite the wrong disk! |
5c6cf7ac DM |
45 | |
46 | ||
e40349c6 | 47 | Find the Correct USB Device Name |
6d16d741 AL |
48 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
49 | There are two ways to find out the name of the USB flash drive. The first one is | |
50 | to compare the last lines of the `dmesg` command output before and after | |
51 | plugging in the flash drive. The second way is to compare the output of the | |
52 | `lsblk` command. Open a terminal and run: | |
5c6cf7ac DM |
53 | |
54 | ---- | |
6d16d741 | 55 | # lsblk |
5c6cf7ac DM |
56 | ---- |
57 | ||
6d16d741 | 58 | Then plug in your USB flash drive and run the command again: |
5c6cf7ac DM |
59 | |
60 | ---- | |
6d16d741 | 61 | # lsblk |
5c6cf7ac DM |
62 | ---- |
63 | ||
6d16d741 AL |
64 | A new device will appear. This is the one you want to use. To be on the extra |
65 | safe side check if the reported size matches your USB flash drive. | |
5c6cf7ac DM |
66 | |
67 | ||
6d16d741 AL |
68 | Instructions for macOS |
69 | ~~~~~~~~~~~~~~~~~~~~~~ | |
5c6cf7ac DM |
70 | |
71 | Open the terminal (query Terminal in Spotlight). | |
72 | ||
d2491438 TL |
73 | Convert the `.iso` file to `.dmg` format using the convert option of `hdiutil`, |
74 | for example: | |
5c6cf7ac DM |
75 | |
76 | ---- | |
af9941ba | 77 | # hdiutil convert proxmox-ve_*.iso -format UDRW -o proxmox-ve_*.dmg |
5c6cf7ac DM |
78 | ---- |
79 | ||
6d16d741 | 80 | TIP: macOS tends to automatically add '.dmg' to the output file name. |
5c6cf7ac | 81 | |
6d16d741 | 82 | To get the current list of devices run the command: |
5c6cf7ac DM |
83 | |
84 | ---- | |
6d16d741 | 85 | # diskutil list |
5c6cf7ac DM |
86 | ---- |
87 | ||
6d16d741 AL |
88 | Now insert the USB flash drive and run this command again to determine which |
89 | device node has been assigned to it. (e.g., /dev/diskX). | |
5c6cf7ac DM |
90 | |
91 | ---- | |
6d16d741 AL |
92 | # diskutil list |
93 | # diskutil unmountDisk /dev/diskX | |
5c6cf7ac DM |
94 | ---- |
95 | ||
96 | NOTE: replace X with the disk number from the last command. | |
97 | ||
98 | ---- | |
d2491438 | 99 | # sudo dd if=proxmox-ve_*.dmg bs=1M of=/dev/rdiskX |
5c6cf7ac DM |
100 | ---- |
101 | ||
6d16d741 AL |
102 | NOTE: 'rdiskX', instead of 'diskX', in the last command is intended. It will |
103 | increase the write speed. | |
5c6cf7ac DM |
104 | |
105 | Instructions for Windows | |
106 | ~~~~~~~~~~~~~~~~~~~~~~~~ | |
107 | ||
fb856a31 TL |
108 | Using Etcher |
109 | ^^^^^^^^^^^^ | |
5c6cf7ac | 110 | |
fb856a31 TL |
111 | Etcher works out of the box. Download Etcher from https://etcher.io. It will |
112 | guide you through the process of selecting the ISO and your USB Drive. | |
5c6cf7ac | 113 | |
fb856a31 TL |
114 | Using Rufus |
115 | ^^^^^^^^^^^ | |
116 | ||
2ad7deac TL |
117 | Rufus is a more lightweight alternative, but you need to use the *DD mode* to |
118 | make it work. Download Rufus from https://rufus.ie/. Either install it or use | |
119 | the portable version. Select the destination drive and the {pve} ISO file. | |
fb856a31 | 120 | |
2ad7deac TL |
121 | IMPORTANT: Once you 'Start' you have to click 'No' on the dialog asking to |
122 | download a different version of GRUB. In the next dialog select the 'DD' mode. | |
5c6cf7ac | 123 | |
44ea3fd6 | 124 | ifdef::wiki[] |
e40349c6 | 125 | Boot your Server from the USB Flash Drive |
6d16d741 | 126 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
5c6cf7ac | 127 | |
6d16d741 | 128 | Connect the USB flash drive to your server and make sure that booting from USB |
9a6dc394 TL |
129 | is enabled (check your servers firmware settings). Then follow the steps in the |
130 | xref:chapter_installation[installation wizard]. | |
44ea3fd6 TL |
131 | |
132 | endif::wiki[] |