kopano-backup - The Kopano Backup tool
kopano-backup [OPTION...] [PATH]
Kopano-backup is used to create or restore backups of user data, such as one or
more stores or folders. This includes emails, calendar items, contacts, etc.,
as well as user settings such as rules, permissions and WebApp settings.
Backups are performed incrementally, when for a given user/store
there already exists a backup directory. This means that only the changes
which occurred since the last backup run are processed.
For backup (not restore) it is possible to process multiple stores
There are options to inspect the contents of a backup directory,
and to restore only individual messages/items.
--auth-pass, -P PASS
Authenticate with specified password.
--auth-user, -U NAME
Authenticate as specified user.
--company, -C NAME
Backup users and public store for specified
--config, -c FILE
Load configuration settings from specified file.
Backup/restore/show deleted items/folders. The default
when backing up is to maintain data which has been soft- or hard-deleted. The
default when restoring is to not restore such data. The default when viewing
the contents of a backup directory is to show such data.
Create 'differential' backup(s), containing all changes
since the previous or regular backup(s), in separate directories called
'differential/username/N'. Differential backups can be inspected using the
--index and --stats options. See also the --merge
--folder, -f PATH
Backup/restore only folder(s) with specified path.
Multiple folders may be specified. Subfolders may be included using
List messages/items contained in specified backup
directory in CSV format. Sourcekeys, respective folders, last modified dates
and subjects are shown for each message/item.
Merge 'differential' backups for a given user into
regular backup. See the --differential option.
--log-level, -l NAME
Specify log-level, for example, 'error', 'warning' 'info'
Only backup/restore meta data, such as settings,
permissions and rules.
--output-dir, -O PATH
Create/update backup directories in the specified
directory, instead of the local directory.
--period-begin, -b DATE
Backup/restore data which was last modified on or after
the specified date (YYYY-MM-DD).
--period-end, -e DATE
Backup/restore data which was last modified before the
specified date (YYYY-MM-DD).
Permanently delete data from backup directory which has
been marked as deleted more than the specified number of days ago.
When specifying folders (--folder), also include
subfolders in backup/restore.
Restore the contents of the specified backup directory.
The respective store is determined automatically, but may also be specified
explicitly, for example using --user.
When restoring, place data under folder with specific
path (or name), for example 'some_folder' or 'Inbox/some_subfolder'.
--server-socket, -s SOCKET
Connect to storage server through specified socket.
Restore message/item with specified sourcekey (as shown
using --index). Must be combined with --restore. Multiple
sourcekeys may be specified.
Do not backup/restore attachments.
Do not backup/restore deleted mail folder.
Do not backup/restore junk folder.
Do not backup/restore meta data, such as settings,
permissions and rules.
Do not backup/restore public store.
--ssl-key, -k FILE
Specify SSL key file.
--ssl-pass, -p PASSWORD
Specify SSL key password.
List folders contained in specified backup directory in
CSV format. Folder sizes are shown for each folder.
--store, -S GUID
Backup specified store. Instead of a GUID, 'public' may
also be specified, to denote the public store.
--user, -u NAME
Backup data of the specified user. Multiple users may be
specified. By default, all users are included. When restoring, restore into
the store of the specified user.
--worker-processes, -w N
When backing up data from multiple stores, process these
stores in parallel, using the specified number of workers.
Backup user 'henk', creating/updating a backup directory with the same name:
kopano-backup -u henk
Restore the same user (possibly on another server):
kopano-backup --restore henk
Backup users 'henk' and 'fred', in parallel, in a specified
kopano-backup -u henk -u fred -w 2 -O backups
Search for message with specific subject:
kopano-backup --index backups/henk | grep subject
Restore single message:
kopano-backup --restore backup/henk --sourcekey
Backup calendars of all users:
kopano-backup -f Calendar -O calendars
Recursively restore inbox of 'fred' into store of 'henk', in
kopano-backup --restore fred -f Inbox -u henk --recursive
Restore everything last modified in 2014:
kopano-backup --restore fred -b 2014-01-01 -e
Create differential backup for 'fred':
kopano-backup --differential -u fred
Inspect specific differential backups:
kopano-backup --stats differential/fred/1
kopano-backup --stats differential/fred/2
Merge differential backups for 'fred':
kopano-backup --merge fred
Written by Kopano.