docs/installation.rst

   1 Installation
   2 ============
   3
   4 `Proxmox Backup`_ is split into a server and client part. The server part
   5 can either be installed with a graphical installer or on top of
   6 Debian_ from the provided package repository.
   7
   8 .. include:: package-repositories.rst
   9
  10 Server installation
  11 -------------------
  12
  13 The backup server stores the actual backed up data and provides a web based GUI
  14 for various management tasks such as disk management.
  15
  16 .. note:: You always need a backup server. It is not possible to use
  17    `Proxmox Backup`_ without the server part.
  18
  19 The disk image (ISO file) provided by Proxmox includes a complete Debian system
  20 ("buster" for version 1.x) as well as all necessary packages for the `Proxmox Backup`_ server.
  21
  22 The installer will guide you through the setup process and allows
  23 you to partition the local disk(s), apply basic system configurations
  24 (e.g. timezone, language, network), and installs all required packages.
  25 The provided ISO will get you started in just a few minutes, and is the
  26 recommended method for new and existing users.
  27
  28 Alternatively, `Proxmox Backup`_ server can be installed on top of an
  29 existing Debian system.
  30
  31 Install `Proxmox Backup`_ with the Installer
  32 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  33
  34 Download the ISO from |DOWNLOADS|.
  35 It includes the following:
  36
  37 * The `Proxmox Backup`_ server installer, which partitions the local
  38   disk(s) with ext4, ext3, xfs or ZFS, and installs the operating
  39   system.
  40
  41 * Complete operating system (Debian Linux, 64-bit)
  42
  43 * Our Linux kernel with ZFS support.
  44
  45 * Complete tool-set to administer backups and all necessary resources
  46
  47 * Web based GUI management interface
  48
  49 .. note:: During the installation process, the complete server
  50    is used by default and all existing data is removed.
  51
  52
  53 Install `Proxmox Backup`_ server on Debian
  54 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  55
  56 Proxmox ships as a set of Debian packages which can be installed on top of a
  57 standard Debian installation.  After configuring the
  58 :ref:`sysadmin_package_repositories`, you need to run:
  59
  60 .. code-block:: console
  61
  62   # apt-get update
  63   # apt-get install proxmox-backup-server
  64
  65 The commands above keep the current (Debian) kernel and install a minimal
  66 set of required packages.
  67
  68 If you want to install the same set of packages as the installer
  69 does, please use the following:
  70
  71 .. code-block:: console
  72
  73   # apt-get update
  74   # apt-get install proxmox-backup
  75
  76 This will install all required packages, the Proxmox kernel with ZFS_
  77 support, and a set of common and useful packages.
  78
  79 Installing `Proxmox Backup`_ on top of an existing Debian_ installation looks easy, but
  80 it presumes that the base system and local storage has been set up correctly.
  81
  82 In general this is not trivial, especially when LVM_ or ZFS_ is used.
  83
  84 The network configuration is completely up to you as well.
  85
  86 Install Proxmox Backup server on `Proxmox VE`_
  87 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  88
  89 After configuring the
  90 :ref:`sysadmin_package_repositories`, you need to run:
  91
  92 .. code-block:: console
  93
  94   # apt-get update
  95   # apt-get install proxmox-backup-server
  96
  97 .. caution:: Installing the backup server directly on the hypervisor
  98    is not recommended. It is safer to use a separate physical
  99    server to store backups. Should the hypervisor server fail, you can
 100    still access the backups.
 101
 102 Client installation
 103 -------------------
 104
 105 Install `Proxmox Backup`_ client on Debian
 106 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 107
 108 Proxmox ships as a set of Debian packages to be installed on
 109 top of a standard Debian installation. After configuring the
 110 :ref:`sysadmin_package_repositories`, you need to run:
 111
 112 .. code-block:: console
 113
 114   # apt-get update
 115   # apt-get install proxmox-backup-client
 116
 117
 118 Installing from source
 119 ~~~~~~~~~~~~~~~~~~~~~~
 120
 121 .. todo:: Add section "Installing from source"
 122
 123 Installing statically linked binary
 124 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 125
 126 .. todo:: Add section "Installing statically linked binary"