4cda7603c4
this fixes minor grammatical errors throughout the pbs docs and rewords certain sections for improved readability. Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>
135 lines
4.2 KiB
ReStructuredText
135 lines
4.2 KiB
ReStructuredText
Installation
|
|
============
|
|
|
|
`Proxmox Backup`_ is split into a server and client part. The server part
|
|
can either be installed with a graphical installer or on top of
|
|
Debian_ from the provided package repository.
|
|
|
|
.. include:: package-repositories.rst
|
|
|
|
Server installation
|
|
-------------------
|
|
|
|
The backup server stores the actual backed up data and provides a web based GUI
|
|
for various management tasks such as disk management.
|
|
|
|
.. note:: You always need a backup server. It is not possible to use
|
|
`Proxmox Backup`_ without the server part.
|
|
|
|
The disk image (ISO file) provided by Proxmox includes a complete Debian system
|
|
("buster" for version 1.x) as well as all necessary packages for the `Proxmox Backup`_ server.
|
|
|
|
The installer will guide you through the setup process and allow
|
|
you to partition the local disk(s), apply basic system configurations
|
|
(e.g. timezone, language, network), and install all required packages.
|
|
The provided ISO will get you started in just a few minutes, and is the
|
|
recommended method for new and existing users.
|
|
|
|
Alternatively, `Proxmox Backup`_ server can be installed on top of an
|
|
existing Debian system.
|
|
|
|
Install `Proxmox Backup`_ with the Installer
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Download the ISO from |DOWNLOADS|.
|
|
It includes the following:
|
|
|
|
* The `Proxmox Backup`_ server installer, which partitions the local
|
|
disk(s) with ext4, ext3, xfs or ZFS, and installs the operating
|
|
system
|
|
|
|
* Complete operating system (Debian Linux, 64-bit)
|
|
|
|
* Our Linux kernel with ZFS support
|
|
|
|
* Complete tool-set to administer backups and all necessary resources
|
|
|
|
* Web based GUI management interface
|
|
|
|
.. note:: During the installation process, the complete server
|
|
is used by default and all existing data is removed.
|
|
|
|
|
|
Install `Proxmox Backup`_ server on Debian
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Proxmox ships as a set of Debian packages which can be installed on top of a
|
|
standard Debian installation. After configuring the
|
|
:ref:`sysadmin_package_repositories`, you need to run:
|
|
|
|
.. code-block:: console
|
|
|
|
# apt-get update
|
|
# apt-get install proxmox-backup-server
|
|
|
|
The commands above keep the current (Debian) kernel and install a minimal
|
|
set of required packages.
|
|
|
|
If you want to install the same set of packages as the installer
|
|
does, please use the following:
|
|
|
|
.. code-block:: console
|
|
|
|
# apt-get update
|
|
# apt-get install proxmox-backup
|
|
|
|
This will install all required packages, the Proxmox kernel with ZFS_
|
|
support, and a set of common and useful packages.
|
|
|
|
Installing `Proxmox Backup`_ on top of an existing Debian_ installation looks easy, but
|
|
it presumes that the base system and local storage has been set up correctly.
|
|
|
|
In general this is not trivial, especially when LVM_ or ZFS_ is used.
|
|
|
|
The network configuration is completely up to you as well.
|
|
|
|
.. note:: You can access the webinterface of the Proxmox Backup Server with
|
|
your web browser, using HTTPS on port 8007. For example at
|
|
``https://<ip-or-dns-name>:8007``
|
|
|
|
Install Proxmox Backup server on `Proxmox VE`_
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
After configuring the
|
|
:ref:`sysadmin_package_repositories`, you need to run:
|
|
|
|
.. code-block:: console
|
|
|
|
# apt-get update
|
|
# apt-get install proxmox-backup-server
|
|
|
|
.. caution:: Installing the backup server directly on the hypervisor
|
|
is not recommended. It is safer to use a separate physical
|
|
server to store backups. Should the hypervisor server fail, you can
|
|
still access the backups.
|
|
|
|
.. note::
|
|
You can access the webinterface of the Proxmox Backup Server with your web
|
|
browser, using HTTPS on port 8007. For example at ``https://<ip-or-dns-name>:8007``
|
|
|
|
Client installation
|
|
-------------------
|
|
|
|
Install `Proxmox Backup`_ client on Debian
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Proxmox ships as a set of Debian packages to be installed on
|
|
top of a standard Debian installation. After configuring the
|
|
:ref:`sysadmin_package_repositories`, you need to run:
|
|
|
|
.. code-block:: console
|
|
|
|
# apt-get update
|
|
# apt-get install proxmox-backup-client
|
|
|
|
|
|
Installing from source
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. todo:: Add section "Installing from source"
|
|
|
|
Installing statically linked binary
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. todo:: Add section "Installing statically linked binary"
|