docs/introduction.rst

   1 Introduction
   2 ============
   3
   4 What is Proxmox Backup Server
   5 -----------------------------
   6
   7 Proxmox Backup Server is an enterprise-class client-server backup software that
   8 backups :term:`virtual machine`\ s, :term:`container`\ s, and physical hosts.
   9 It is specially optimized for the `Proxmox Virtual Environment`_ platform and
  10 allows you to backup your data securely, even between remote sites, providing
  11 easy management with a web-based user interface.
  12
  13 Proxmox Backup Server supports deduplication, compression, and authenticated
  14 encryption (AE_). Using :term:`Rust` as implementation language guarantees high
  15 performance, low resource usage, and a safe, high quality code base.
  16
  17 It features strong encryption done on the client side. Thus, it's possible to
  18 backup data to not fully trusted targets.
  19
  20
  21 Architecture
  22 ------------
  23
  24 Proxmox Backup Server uses a `client-server model`_. The server stores the
  25 backup data and provides an API to create backups and restore data. With the
  26 API it's also possible to manage disks and other server side resources.
  27
  28 The backup client uses this API to access the backed up data. With the command
  29 line tool ``proxmox-backup-client`` you can create backups and restore data.
  30 For QEMU_ with `Proxmox Virtual Environment`_ we deliver an integrated client.
  31
  32 A single backup is allowed to contain several archives. For example, when you
  33 backup a :term:`virtual machine`, each disk is stored as a separate archive
  34 inside that backup. The VM configuration itself is stored as an extra file.
  35 This way, it is easy to access and restore only important parts of the backup
  36 without the need to scan the whole backup.
  37
  38
  39 Main Features
  40 -------------
  41
  42 :Support for Proxmox VE: The `Proxmox Virtual Environment`_ is fully
  43    supported and you can easily backup :term:`virtual machine`\ s and
  44    :term:`container`\ s.
  45
  46 :Performance: The whole software stack is written in :term:`Rust`,
  47    to provide high speed and memory efficiency.
  48
  49 :Deduplication: Periodic backups produce large amounts of duplicate
  50    data. The deduplication layer avoids redundancy and minimizes the used
  51    storage space.
  52
  53 :Incremental backups: Changes between backups are typically low. Reading and
  54    sending only the delta reduces storage and network impact of backups.
  55
  56 :Data Integrity: The built-in `SHA-256`_ checksum algorithm assures the
  57    accuracy and consistency of your backups.
  58
  59 :Remote Sync: It is possible to efficiently synchronize data to remote
  60    sites. Only deltas containing new data are transferred.
  61
  62 :Compression: The ultra fast Zstandard_ compression is able to compress
  63    several gigabytes of data per second.
  64
  65 :Encryption: Backups can be encrypted on the client-side using AES-256 in
  66    Galois/Counter Mode (GCM_) mode. This authenticated encryption (AE_) mde
  67    provides very high performance on modern hardware.
  68
  69 :Web interface: Manage the Proxmox Backup Server with the integrated web-based
  70    user interface.
  71
  72 :Open Source: No secrets. Proxmox Backup Server is free and open-source
  73    software. The source code is licensed under AGPL, v3.
  74
  75 :Support: Enterprise support will be available from `Proxmox`_ once the beta
  76    phase is over.
  77
  78
  79 Reasons for Data Backup?
  80 ------------------------
  81
  82 The main purpose of a backup is to protect against data loss. Data loss can be
  83 caused by faulty hardware but also by human error.
  84
  85 A common mistake is to accidentally delete a file or folder which is still
  86 required. Virtualization can even amplify this problem; it easily happens that
  87 a whole virtual machine is deleted by just pressing a single button.
  88
  89 For administrators, backups can serve as a useful toolkit for temporarily
  90 storing data. For example, it is common practice to perform full backups before
  91 installing major software updates. If something goes wrong, you can easily
  92 restore the previous state.
  93
  94 Another reason for backups are legal requirements. Some data, especially
  95 business records, must be kept in a safe place for several years by law, so
  96 that they can be accessed if required.
  97
  98 In general, data loss is very costly as it can severely damage your business.
  99 Therefore, ensure that you perform regular backups and run restore tests.
 100
 101
 102 Software Stack
 103 --------------
 104
 105 .. todo:: Eplain why we use Rust (and Flutter)
 106
 107
 108 Getting Help
 109 ------------
 110
 111 Community Support Forum
 112 ~~~~~~~~~~~~~~~~~~~~~~~
 113
 114 We always encourage our users to discuss and share their knowledge using the
 115 `Proxmox Community Forum`_. The forum is moderated by the Proxmox support team.
 116 The large user base is spread out all over the world. Needless to say that such
 117 a large forum is a great place to get information.
 118
 119 Mailing Lists
 120 ~~~~~~~~~~~~~
 121
 122 Proxmox Backup Server is fully open-source and contributions are welcome! Here
 123 is the primary communication channel for developers:
 124 :Mailing list for developers: `PBS Development List`_
 125
 126 Bug Tracker
 127 ~~~~~~~~~~~
 128
 129 Proxmox runs a public bug tracker at `<https://bugzilla.proxmox.com>`_. If an
 130 issue appears, file your report there. An issue can be a bug as well as a
 131 request for a new feature or enhancement. The bug tracker helps to keep track
 132 of the issue and will send a notification once it has been solved.
 133
 134 License
 135 -------
 136
 137 Copyright (C) 2019-2020 Proxmox Server Solutions GmbH
 138
 139 This software is written by Proxmox Server Solutions GmbH <support@proxmox.com>
 140
 141 Proxmox Backup Server is free and open source software: you can use it,
 142 redistribute it, and/or modify it under the terms of the GNU Affero General
 143 Public License as published by the Free Software Foundation, either version 3
 144 of the License, or (at your option) any later version.
 145
 146 This program is distributed in the hope that it will be useful, but
 147 ``WITHOUT ANY WARRANTY``; without even the implied warranty of
 148 ``MERCHANTABILITY`` or ``FITNESS FOR A PARTICULAR PURPOSE``.  See the GNU
 149 Affero General Public License for more details.
 150
 151 You should have received a copy of the GNU Affero General Public License
 152 along with this program.  If not, see AGPL3_.
 153
 154
 155 History
 156 -------
 157
 158 .. todo:: Add development History of the product
 159