Installing Proxmox VE
----------------------
-include::attributes.txt[]
+=====================
+ifndef::manvolnum[]
+:pve-toplevel:
+endif::manvolnum[]
+ifdef::wiki[]
+:title: Installation
+endif::wiki[]
-{pve} ships as a set of Debian packages, so you can simply install it
-on top of a normal Debian installation, or download the installation
-CD-ROM and use that to install {pve} on your hardware.
+{pve} is based on Debian and comes with an installation CD-ROM
+which includes a complete Debian ("jessie" for Proxmox VE 4.x) system as
+well as all necessary Proxmox VE packages. The
+installer just asks you a few questions, then partitions the local
+disk(s), installs all required packages, and configures the system
+including a basic network setup. You can get a fully functional system
+within a few minutes. This is the preferred and recommended installation method.
-Installing on top of an existing Debian installation looks easy, but
-it presumes that you have correctly installed the base system, and you
-know how you want to configure and use the local storage. Network
-configuration is also completely up to you.
+Alternatively, Proxmox VE can be installed on top of an existing Debian system.
+This option is only recommended for advanced users since detail knowledge about
+Proxmox VE is necessary.
-In general, this is not trivial, especially when you use LVM or
-ZFS. This is why we provide an installation CD-ROM for {pve}. That
-installer just ask you a few questions, then partitions the local
-disk(s), installs all required packages and configures the system
-including a basic network setup. You can get a fully functional system
-within a few minutes, including the following:
+ifndef::wiki[]
-* Complete operating system (Debian Linux, 64-bit)
-* Partition the hard drive with ext4 (alternative ext3 or xfs) or ZFS
-* {pve} Kernel with LXC and KVM support
-* Complete toolset
-* Web based management interface
+include::pve-system-requirements.adoc[]
+
+endif::wiki[]
Using the {pve} Installation CD-ROM
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-----------------------------------
+
+Includes the following:
+
+* Complete operating system (Debian Linux, 64-bit)
+
+* Partitioning of the hard drive(s) containing the operating system
+ with ext4, ext3, xfs or ZFS
+
+* {pve} kernel with LXC and KVM support
+
+* Complete toolset for administering virtual machines, containers and
+ all necessary resources
+
+* Web based management interface for using the toolset
-This is the preferred and recommended installation method.
NOTE: By default, the complete server is used and all existing data is
removed.
if you do not have a hardware RAID controller. The `Options` button
lets you select the ZFS RAID level, and you can choose disks there.
-The next pages just asks for basic configuration options like time
+The next pages just ask for basic configuration options like time
zone and keyboard layout. You also need to specify your email address
-and select a superuser password.
+and superuser (root) password (must have at least 5 characters).
The last step is the network configuration. Please note that you can
use either IPv4 or IPv6 here, but not both. If you want to configure a
Further configuration is done via the Proxmox web interface. Just
point your browser to the IP address given during installation
-(https://youripaddress:8006). {pve} is tested for IE9, Firefox 10
-and higher, and Google Chrome.
+(https://youripaddress:8006).
NOTE: Default login is "root" (realm 'PAM') and the root password is
defined during the installation process.
[[advanced_lvm_options]]
Advanced LVM Configuration Options
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The installer creates a Volume Group (VG) called `pve`, and additional
Logical Volumes (LVs) called `root`, `data` and `swap`. The size of
`swapsize`::
-To define the size of the `swap` volume. Default is the same size as
-installed RAM, with 4GB minimum and `hdsize/8` as maximum.
+Defines the size of the `swap` volume. The default is the size of the
+installed memory, minimum 4 GB and maximum 8 GB. The resulting value cannot
+be greater than `hdsize/8`.
`maxroot`::
-The `root` volume size. The `root` volume stores the whole operation
-system.
+Defines the maximum size of the `root` volume, which stores the operation
+system. The maximum limit of the `root` volume size is `hdsize/4`.
`maxvz`::
-Define the size of the `data` volume, which is mounted at
-`/var/lib/vz`.
+Defines the maximum size of the `data` volume. The actual size of the `data`
+volume is:
++
+`datasize = hdsize - rootsize - swapsize - minfree`
++
+Where `datasize` cannot be bigger than `maxvz`.
`minfree`::
-To define the amount of free space left in LVM volume group `pve`.
-16GB is the default if storage available > 128GB, `hdsize/8` otherwise.
+Defines the amount of free space left in LVM volume group `pve`.
+With more than 128GB storage available the default is 16GB, else `hdsize/8`
+will be used.
+
NOTE: LVM requires free space in the VG for snapshot creation (not
required for lvmthin snapshots).
ZFS Performance Tips
-^^^^^^^^^^^^^^^^^^^^
+~~~~~~~~~~~~~~~~~~~~
-ZFS uses a lot of memory, so it is best to add additional 8-16GB RAM
-if you want to use ZFS.
+ZFS uses a lot of memory, so it is best to add additional RAM if you
+want to use ZFS. A good calculation is 4GB plus 1GB RAM for each TB
+RAW disk space.
ZFS also provides the feature to use a fast SSD drive as write cache. The
write cache is called the ZFS Intent Log (ZIL). You can add that after
ifdef::wiki[]
link:/wiki/Install_Proxmox_VE_on_Debian_Jessie[Install Proxmox VE on Debian Jessie]
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-----------------------------------------------------------------------------------
+
+link:/wiki/Install_from_USB_Stick[Install from USB Stick]
+---------------------------------------------------------
endif::wiki[]
ifndef::wiki[]
Install {pve} on Debian
-~~~~~~~~~~~~~~~~~~~~~~~
+-----------------------
-{pve} ships as a set of Debian packages, so you can simply install it
-on top of a normal Debian installation. After configuring the
+{pve} ships as a set of Debian packages, so you can install it
+on top of a normal Debian installation. After configuring the
repositories, you need to run:
[source,bash]
apt-get install proxmox-ve
----
-You can find a detailed step by step howto on the {pve}
-http://pve.proxmox.com/wiki/Install_Proxmox_VE_on_Debian_Jessie[wiki].
+Installing on top of an existing Debian installation looks easy, but
+it presumes that you have correctly installed the base system, and you
+know how you want to configure and use the local storage. Network
+configuration is also completely up to you.
-endif::wiki[]
+In general, this is not trivial, especially when you use LVM or
+ZFS.
+
+You can find a detailed step by step howto on the
+{webwiki-url}Install_Proxmox_VE_on_Debian_Jessie[wiki].
+include::pve-usbstick.adoc[]
+
+endif::wiki[]
ifdef::wiki[]
Video Tutorials
-~~~~~~~~~~~~~~~
+---------------
* List of all official tutorials on our
http://www.youtube.com/proxmoxve[Proxmox VE YouTube Channel]
See Also
-~~~~~~~~
+--------
+
+* link:/wiki/System_Requirements[System Requirements]
* link:/wiki/Package_Repositories[Package Repositories]
* link:/wiki/Installation:_Tips_and_Tricks[Installation: Tips and Tricks]
endif::wiki[]
-