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 .. note:: You can access the webinterface of the Proxmox Backup Server with
  87   your web browser, using HTTPS on port 8007. For example at
  88  ``https://<ip-or-dns-name>:8007``
  89
  90 Install Proxmox Backup server on `Proxmox VE`_
  91 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  92
  93 After configuring the
  94 :ref:`sysadmin_package_repositories`, you need to run:
  95
  96 .. code-block:: console
  97
  98   # apt-get update
  99   # apt-get install proxmox-backup-server
 100
 101 .. caution:: Installing the backup server directly on the hypervisor
 102    is not recommended. It is safer to use a separate physical
 103    server to store backups. Should the hypervisor server fail, you can
 104    still access the backups.
 105
 106 .. note:: You can access the webinterface of the Proxmox Backup Server with
 107   your web browser, using HTTPS on port 8007. For example at
 108  ``https://<ip-or-dns-name>:8007``
 109
 110 Client installation
 111 -------------------
 112
 113 Install `Proxmox Backup`_ client on Debian
 114 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 115
 116 Proxmox ships as a set of Debian packages to be installed on
 117 top of a standard Debian installation. After configuring the
 118 :ref:`sysadmin_package_repositories`, you need to run:
 119
 120 .. code-block:: console
 121
 122   # apt-get update
 123   # apt-get install proxmox-backup-client
 124
 125
 126 Installing from source
 127 ~~~~~~~~~~~~~~~~~~~~~~
 128
 129 .. todo:: Add section "Installing from source"
 130
 131 Installing statically linked binary
 132 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 133
 134 .. todo:: Add section "Installing statically linked binary"