DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:backup

BackupTool for DokuWiki

Compatible with DokuWiki

  • 2024-02-06 "Kaos" yes
  • 2023-04-04 "Jack Jackrum" yes
  • 2022-07-31 "Igor" yes
  • 2020-07-29 "Hogfather" unknown

plugin Backup your site and configuration data to a file

Last updated on
2020-10-21
Provides
Admin
Repository
Source

Security warning (please read plugin security guidelines): Be sure the backup namespace is properly protected by ACLs. The default wiki:backup is often publicly readable!

Similar to archivegenerator, zip

Tagged with archive, backup, maintenance

:!: The plugin's author has announced he retired support and marked the repository as archived, so this plugin's future is uncertain.

This is a plugin for DokuWiki which enables you to backup the most important parts of your site; this includes all of your pages, all old revisions, meta data, subscriptions, media files (your downloads), as well as your plugins and templates.

Installation

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

As with any data backup tool, there is always a possibility for unintentional data loss. As per the plugin's license, no warranties are given. Use and download at you own risk.

Changes

Usage

To access the plugin, make sure you're on the admin account, and click the admin button on your wiki site.

An entry named “Backup Tool” should be listed in the the available administrative tasks. Click it, and you will see a list of components to backup.

Simply check the items you wish to backup, and uncheck the ones you don't. For instance, you may not care about old revisions of documents, so you don't have to include them if you don't want to.

Click the Create Backup button, and the process of backing up starts. For large sites, it may take some time; it may even time out– in which case you may wish to backup each section individually– though this is unlikely. It will usually take at least a little time for the page to respond, so please be patient.

The backup file is generated and put in your media directory. So you're then able to download it from there, and you may wish to delete it afterwards.

:!: It is important to secure the backup namespace by ACLs otherwise your backup files can be downloaded by anyone :!:

Restoring a Backup

The following assumes that your Wiki is completely gone - you have nothing left then one backup-archive and the credentials of the Admin-User. It also assumes that you backed up at least your configuration and pages.

  1. Start the installation of the latest version of DokuWiki as if you would start with a new wiki
  2. Untar your backup and copy the three directories (conf, data and lib) to your wikis destination-dir, overwriting any possibly existing files
  3. You should now be able to log in with your previously used admin account.
plugin/backup.txt · Last modified: 2024-04-16 16:31 by andi

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki