Skip to content

Commit

Permalink
Added features
Browse files Browse the repository at this point in the history
  • Loading branch information
framps committed Nov 5, 2017
1 parent 4a40278 commit 428fdd7
Showing 1 changed file with 52 additions and 6 deletions.
58 changes: 52 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,58 @@
# raspiBackup
# raspiBackup - Backup and restore your Raspberry

## Backup and restore your raspberry
## Features

For detailed documentation and download of the latest version of raspiBackup and it's installation script [see here in English](https://www.linux-tips-and-tricks.de/en/backup) and [here in German](https://www.linux-tips-and-tricks.de/de/raspiBackup)
* Unattended backup of a running Raspberry Pi (Pi backups itself)
* Other similar SoCs are supported (Banana Pi, Ondroid, Beagle Board, Cubieboard, ...)
* Support of Raspberry3 running without SD card (booted from USB)
* Partitionoriented backupmode backups a variable number of partitions of the SD card and thus can save NOOBs images and images with more than 2 partitions
* Backup and restore is independent of the operating system (Linux, Windows or Mac) used to access the Raspberry Pi
* Windows or Mac user just use the Raspberry to restore their backup
* Windows user can restore dd backups with win32diskimager
* Linux user can use their Linux system or the Raspberry to restore the backup
* Plugins allow to extend the script capabilities with custom code
* Various backup targets, for example
* External USB stick
* External USB disk
* Synology drives
* cifs/samba mounted network drive
* nfs mounted network drive
* sshfs mounted network drive
* webdav network drive
* Mounted ftp server
* In general every device which can be mounted on Linux
* Simple restore of the backup
* An external root filesystem on disk or USB stick will be saved with in the normal backup mode if tar or rsync backup is used
* Can be used to clone Raspberry Pi
* Simple installation. A configuration wizzard helps to configure the most important parameters.
* Messages in English and German
* Lots of invocation parameters to customize the backup process
* dd, tar and rsync backup possible (-t option). rsync requires an ext3/ext4 partition for hardlinks
* dd and tar can be zipped to reduce the backup size (-z option)
* dd backup can be enabled to save only the space used by the partitions. That way a 32GB SD card with a 8GB partition will only need 8GB for backup
* Boot partition backups are saved with hardlinks to save backup space if enabled with an option
* Different backup types can be mixed per system (e.g. day backup uses rsync, weekly backup uses dd)
* Automatic stop and start of running services before and after the backup (-a and -o option)
* Sample script helps to easily add additional activities to be executed before and after the backup. E.g. mount and unmount of the backup device
* Number of backups to keep is configurable (-k option)
* If the target SD card is smaller or larger than the original SD card the second root partition will be adjusted accordingly
* eMail is sent to report the backup result (-e option)
* rsync uses hardlinks to reduce the backup size
* Supported eMail programs: mailx/mail, sendEmail and ssmtp (-s option)
* Unsupported eMail clients can be used via the eMailPlugin
* Automatic notification if there is a newer version of raspiBackup available (-n option)
* Simple update of raspiBackup to the latest version (-U option)
* Simple restore of a previous version of raspiBackup (-V option)
* Arbitrary directories and files can be excluded from the backup (-u option)
* Multiple Raspberries can save their backup at the same place

For the list of all fixes and enhancemants of raspiBackup [see here in English](https://www.linux-tips-and-tricks.de/en/versionhistory) and [here in German](https://www.linux-tips-and-tricks.de/de/versionshistorie)
## More detailed information

## Miscellaneous tools and utilities for raspiBackup
* Quickstart, FAQ, detailed description of options, version history and more
* [English](https://www.linux-tips-and-tricks.de/en/backup)
* [German](https://www.linux-tips-and-tricks.de/de/raspiBackup)

# Miscellaneous tools and utilities

* Wrapper script for raspiBackup to add any activities before and after backup [(Code)](https://github.com/framps/raspiBackup/blob/master/helper/raspiBackupWrapper.sh)

Expand All @@ -26,7 +72,7 @@ For the list of all fixes and enhancemants of raspiBackup [see here in English](
* Sample pre/post extension which initiates different actions depending on the return code of raspiBackup
* Sample ready extension which copies /etc/fstab into the backup directory

## REST API Server proof of concept
# REST API Server proof of concept

Allows to start a backup from a remote system or any web UI.
1. Download executable from RESTAPI directory
Expand Down

0 comments on commit 428fdd7

Please sign in to comment.