+[[chapter_installation]]
Installing {pve}
================
ifndef::manvolnum[]
endif::wiki[]
{pve} is based on Debian. This is why the install disk images (ISO files)
-provided by Proxmox include a complete Debian system (Debian 10 "buster" for
+provided by Proxmox include a complete Debian system (Debian 10 Buster for
{pve} version 6.x) as well as all necessary {pve} packages.
The installer will guide through the setup, allowing you to partition the local
-disk(s), apply basic system configurations (e.g. timezone, language, network)
-and install all required packages. This process should not take more than a few
-minutes. Installing with the provided ISO is the recommended method for new and
-existing users.
+disk(s), apply basic system configurations (for example, timezone, language,
+network) and install all required packages. This process should not take more
+than a few minutes. Installing with the provided ISO is the recommended method
+for new and existing users.
Alternatively, {pve} can be installed on top of an existing Debian system. This
option is only recommended for advanced users because detailed knowledge about
include::pve-system-requirements.adoc[]
+include::pve-installation-media.adoc[]
+
endif::wiki[]
+[[installation_installer]]
Using the {pve} Installer
-------------------------
-Download the installer ISO at {website}en/downloads. It includes the following:
+The installer ISO image includes the following:
* Complete operating system (Debian Linux, 64-bit)
-* The {pve} installer, which partitions the local disk(s) with ext4,
- ext3, xfs or ZFS and installs the operating system.
+* The {pve} installer, which partitions the local disk(s) with ext4, ext3, xfs
+ or ZFS and installs the operating system.
-* {pve} kernel (Linux) with KVM and LXC support
+* {pve} Linux kernel with KVM and LXC support
-* Complete toolset for administering virtual machines, containers and
- all necessary resources
+* Complete toolset for administering virtual machines, containers, the host
+ system, clusters and all necessary resources
* Web-based management interface
-NOTE: All existing data on the server will be removed during the installation
-process.
+NOTE: All existing data on the for installation selected drives will be removed
+during the installation process. The installer does not add boot menu entries
+for other operating systems.
+
+Please insert the xref:installation_prepare_media[prepared installation media]
+(for example, USB flash drive or CD-ROM) and boot from it.
-Please insert the installation media (e.g. USB flash drive, CD-ROM) and boot
-from it.
+TIP: Make sure that booting from the installation medium (for example, USB) is
+enabled in your servers firmware settings.
[thumbnail="screenshot/pve-grub-menu.png"]
Starts the installation in debug mode. A console will be opened at several
installation steps. This helps to debug the situation if something goes wrong.
-To exit a debug console, press `CTRL-D`. This options is primarily for
-developers and not intended for general use.
+To exit a debug console, press `CTRL-D`. This option can be used to boot a live
+system with all basic tools available. You can use it, for example, to
+xref:chapter_zfs[repair a degraded ZFS 'rpool'] or fix the
+xref:sysboot[bootloader] for an existing {pve} setup.
Rescue Boot::
`swapsize`::
-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`.
+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`.
+
NOTE: If set to `0`, no `swap` volume will be created.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The installer creates the ZFS pool `rpool`. No swap space is created but you can
reserve some unpartitioned space on the install disks for swap. You can also
-create a swap zvol after the installation, altough this can lead to problems.
+create a swap zvol after the installation, although this can lead to problems.
(see <<zfs_swap,ZFS swap notes>>).
`ashift`::
`hdsize`::
Defines the total hard disk size to be used. This is useful to save free space
-on the hard disk(s) for further partitioning (for exmaple to create a
+on the hard disk(s) for further partitioning (for example to create a
swap-partition). `hdsize` is only honored for bootable disks, that is only the
first disk or mirror for RAID0, RAID1 or RAID10, and all disks in RAID-Z[123].
# zpool add <pool-name> log </dev/path_to_fast_ssd>
----
-ifdef::wiki[]
-
-link:/wiki/Install_from_USB_Stick[Install from USB Stick]
----------------------------------------------------------
-
-link:/wiki/Install_Proxmox_VE_on_Debian_Buster[Install Proxmox VE on Debian Buster]
------------------------------------------------------------------------------------
-
-endif::wiki[]
-
ifndef::wiki[]
-include::pve-usbstick.adoc[]
-
Install {pve} on Debian
-----------------------
In general, this is not trivial, especially when LVM or ZFS is used.
A detailed step by step how-to can be found on the
-{webwiki-url}Install_Proxmox_VE_on_Debian_Stretch[wiki].
+{webwiki-url}Install_Proxmox_VE_on_Debian_Buster[wiki].
endif::wiki[]
See Also
--------
+* link:/wiki/Prepare_Installation_Media[Prepare Installation Media]
+
+* link:/wiki/Install_Proxmox_VE_on_Debian_Buster[Install Proxmox VE on Debian Buster]
+
* link:/wiki/System_Requirements[System Requirements]
* link:/wiki/Package_Repositories[Package Repositories]