]>
Commit | Line | Data |
---|---|---|
6d16d741 AL |
1 | Install from a USB flash drive |
2 | ------------------------------ | |
5f09af76 DM |
3 | ifdef::wiki[] |
4 | :pve-toplevel: | |
5 | endif::wiki[] | |
6 | ||
6d16d741 | 7 | The {pve} installation media is a hybrid ISO image. It works in two ways: |
5c6cf7ac | 8 | |
6d16d741 | 9 | * An ISO image file ready to burn to a CD or DVD. |
5c6cf7ac | 10 | |
6d16d741 | 11 | * A raw sector (IMG) image file ready to copy to a USB flash drive (USB stick). |
5c6cf7ac | 12 | |
6d16d741 AL |
13 | Using a USB flash drive to install {pve} is the recommended way because it is |
14 | the faster option. | |
5c6cf7ac | 15 | |
6d16d741 AL |
16 | Prepare a USB flash drive as installation medium |
17 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
5c6cf7ac | 18 | |
6d16d741 | 19 | Download the installer ISO image from: |
5c6cf7ac DM |
20 | https://www.proxmox.com/en/downloads/category/iso-images-pve |
21 | ||
6d16d741 | 22 | The flash drive needs to have at least 1GB 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 | ---- | |
6d16d741 | 38 | # dd if=proxmox-ve_*.iso of=/dev/XYZ bs=1M |
5c6cf7ac DM |
39 | ---- |
40 | ||
41 | NOTE: Be sure to replace /dev/XYZ with the correct device name. | |
42 | ||
6d16d741 | 43 | CAUTION: Be very careful, and do not overwrite the wrong disk! |
5c6cf7ac DM |
44 | |
45 | ||
6d16d741 AL |
46 | Find the correct USB device name |
47 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
48 | There are two ways to find out the name of the USB flash drive. The first one is | |
49 | to compare the last lines of the `dmesg` command output before and after | |
50 | plugging in the flash drive. The second way is to compare the output of the | |
51 | `lsblk` command. Open a terminal and run: | |
5c6cf7ac DM |
52 | |
53 | ---- | |
6d16d741 | 54 | # lsblk |
5c6cf7ac DM |
55 | ---- |
56 | ||
6d16d741 | 57 | Then plug in your USB flash drive and run the command again: |
5c6cf7ac DM |
58 | |
59 | ---- | |
6d16d741 | 60 | # lsblk |
5c6cf7ac DM |
61 | ---- |
62 | ||
6d16d741 AL |
63 | A new device will appear. This is the one you want to use. To be on the extra |
64 | safe side check if the reported size matches your USB flash drive. | |
5c6cf7ac DM |
65 | |
66 | ||
6d16d741 AL |
67 | Instructions for macOS |
68 | ~~~~~~~~~~~~~~~~~~~~~~ | |
5c6cf7ac DM |
69 | |
70 | Open the terminal (query Terminal in Spotlight). | |
71 | ||
6d16d741 | 72 | Convert the .iso file to .img using the convert option of `hdiutil` for example. |
5c6cf7ac DM |
73 | |
74 | ---- | |
6d16d741 | 75 | # hdiutil convert -format UDRW -o proxmox-ve_*.dmg proxmox-ve_*.iso |
5c6cf7ac DM |
76 | ---- |
77 | ||
6d16d741 | 78 | TIP: macOS tends to automatically add '.dmg' to the output file name. |
5c6cf7ac | 79 | |
6d16d741 | 80 | To get the current list of devices run the command: |
5c6cf7ac DM |
81 | |
82 | ---- | |
6d16d741 | 83 | # diskutil list |
5c6cf7ac DM |
84 | ---- |
85 | ||
6d16d741 AL |
86 | Now insert the USB flash drive and run this command again to determine which |
87 | device node has been assigned to it. (e.g., /dev/diskX). | |
5c6cf7ac DM |
88 | |
89 | ---- | |
6d16d741 AL |
90 | # diskutil list |
91 | # diskutil unmountDisk /dev/diskX | |
5c6cf7ac DM |
92 | ---- |
93 | ||
94 | NOTE: replace X with the disk number from the last command. | |
95 | ||
96 | ---- | |
6d16d741 | 97 | # sudo dd if=proxmox-ve_*.dmg of=/dev/rdiskX bs=1m |
5c6cf7ac DM |
98 | ---- |
99 | ||
6d16d741 AL |
100 | NOTE: 'rdiskX', instead of 'diskX', in the last command is intended. It will |
101 | increase the write speed. | |
5c6cf7ac DM |
102 | |
103 | Instructions for Windows | |
104 | ~~~~~~~~~~~~~~~~~~~~~~~~ | |
105 | ||
6d16d741 AL |
106 | Download Rufus from https://rufus.ie/. Either install it or use the portable |
107 | version. Select the destination drive and the {pve} ISO file. | |
5c6cf7ac | 108 | |
6d16d741 AL |
109 | Once you click 'Start' a dialog asking to download a different version of GRUB |
110 | will show up. Click 'No'. In the next dialog select the 'DD' mode. | |
5c6cf7ac | 111 | |
6d16d741 AL |
112 | An alternative to Rufus is Etcher. Download Etcher from https://etcher.io. It |
113 | will guide you through the process of selecting the ISO and your USB Drive. | |
5c6cf7ac | 114 | |
6d16d741 AL |
115 | Boot your server from the USB flash drive |
116 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
5c6cf7ac | 117 | |
6d16d741 AL |
118 | Connect the USB flash drive to your server and make sure that booting from USB |
119 | is enabled (check your servers BIOS). Then follow the steps in the installation | |
120 | wizard. |