[pve-docs.git] / pve-usbstick.adoc

Install from USB Stick
----------------------
ifdef::wiki[]
:pve-toplevel:
endif::wiki[]

The {pve} installation media is a hybrid ISO image, working in two ways:

* An ISO image file ready to burn on CD

* A raw sector (IMG) image file ready to directly copy to flash media
  (USB Stick)

Using USB sticks is faster and more environmental friendly and
therefore the recommended way to install {pve}.


Prepare a USB flash drive as install medium
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

In order to boot the installation media, copy the ISO image to a USB
media.

First download the ISO image from
https://www.proxmox.com/en/downloads/category/iso-images-pve

You need at least a 1 GB USB media.

NOTE: Using UNetbootin or Rufus does not work.

IMPORTANT: Make sure that the USB media is not mounted and does not
contain any important data.


Instructions for GNU/Linux
~~~~~~~~~~~~~~~~~~~~~~~~~~

You can simply use `dd` on UNIX like systems. First download the ISO
image, then plug in the USB stick. You need to find out what device
name gets assigned to the USB stick (see below). Then run:

----
dd if=proxmox-ve_*.iso of=/dev/XYZ bs=1M
----

NOTE: Be sure to replace /dev/XYZ with the correct device name.

CAUTION: Be very careful, and do not overwrite the hard disk!


Find Correct USB Device Name
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You can compare the last lines of 'dmesg' command before and after the
insertion, or use the 'lsblk' command. Open a terminal and run:

----
 lsblk
----

Then plug in your USB media and run the command again:

----
 lsblk
----

A new device will appear, and this is the USB device you want to use.


Instructions for OSX
~~~~~~~~~~~~~~~~~~~~

Open the terminal (query Terminal in Spotlight).

Convert the .iso file to .img using the convert option of hdiutil for example.

----
hdiutil convert -format UDRW -o proxmox-ve_*.dmg proxmox-ve_*.iso
----

TIP: OS X tends to put the .dmg ending on the output file automatically.

To get the current list of devices run the command again:

----
diskutil list
----

Now insert your USB flash media and run this command again to
determine the device node assigned to your flash media
(e.g. /dev/diskX).

----
diskutil list

diskutil unmountDisk /dev/diskX
----

NOTE: replace X with the disk number from the last command.

----
sudo dd if=proxmox-ve_*.dmg of=/dev/rdiskX bs=1m
----

NOTE: 'rdiskX', instead of 'diskX', in the last command is intended,
this will increase write speed

Instructions for Windows
~~~~~~~~~~~~~~~~~~~~~~~~

Download Etcher from https://etcher.io , select the ISO and your USB Drive.

If this doesn't work, alternatively use the OSForensics USB
installer from http://www.osforensics.com/portability.html


Boot your server from USB media
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Connect your USB media to your server and make sure that the server
boots from USB (see server BIOS). Then follow the installation wizard.
Commit	Line	Data
	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.