Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


The tool for migration from Dokuwiki and XWiki to Atlassian Confluence: easy and for free

Table of Contents

  1. Capabilities
  2. Migrate Dokuwiki
  3. Migrate XWiki
  4. Some notes
  5. Needed Perl modules


WikiLumper can:

  • Copy all articles
  • Copy all attachments
  • Translate markup (at best effort)
  • Save the pages hierarchy

WikiLumper can not:

  • Save authors
  • Save history

Migrate Dokuwiki

Dokuwiki stores all the articles as simple txt files and all the attachments as ordinary files on the filesystem. Just copy the folders with pages and media to the machine from where you plan to do the job. Then edit and define the path to these folders in 'pages' and 'media' keys. Then configure the Confluence parameters and run All the pages that could not be accessed by links will be placed under "Orphaned pages".

Migrate XWiki

You can export the archive of the XWiki pages by accessing the url http://yourwikiserver/xwiki/bin/export/Space/Page?format=xar. Unarchive the downloaded xar-file, look through the folder and delete unneeded ones. All the articles are stores as xml files with all the attachments encoded as base64 in them. Edit define the path to your unarchived backup and configure Confluence settings. Then just run

Some notes

First you will need to rename config.pl_example to and edit it for your needs. You will have no problems with it if you have some familiarity with Perl syntax (even if not). Then you just run the script:

./ [--debug]

It is a good idea to create a fresh Confluence space for the migration. If the migration goes well then you just move the migrated data to your working space. If the migration fails or the results are not satisfying then you can just drop the space and repeat or look for some other options.

Needed Perl modules

  • LWP::UserAgent
  • JSON
  • MIME::Base64
  • Data::Dumper
  • Getopt::Long
  • XML::Parser


The tool for migrating Dokuwiki and XWiki to Atlassian Confluence



No releases published


No packages published


You can’t perform that action at this time.