Road Runner Documentation

Description:

RoadRunner allows you to take Confluencecontent (pages and attachments) with you offline. Also you can create / update / fine tune content offline before sending it back to the server where it's public.

RoadRunner is a Confluence plugin (or stand alone app) which synchronizes content from one or multiple Confluence servers down to a your local desktop or laptop running a personal version of Confluence.

This is an executable jar so you can either double click to run or type: java -jar rr.jar

Uses for Road Runner

• consultants traveling can have an up to date copy of Confluence running locally on their laptops without concerns about connectivity.
• creating documentation locally and off line before it's viewable to everyone is now a piece of cake
• creating and updating content is no longer hampered by network latency

Running RoadRunner

• check the prerequisites - mainly just have installed a local version of Confluence with Atlassian's free personal license
• downloadRoadRunner
• to run it either:
  • double click the jar or
  • at a shell type: java -jar rr.jar

Learn how to use RoadRunner

The fastest ways to learn to use RoadRunner are:

• SeeRoadRunnerDocumentation by screenshot
• watch this short video on how to use it http://www.screencast.com/t/aQ3Qw3nxm4

Current Features (updated for v0.4.0)

• synchronization of Confluence server content to your local computer
  • Confluence pages
  • attachments
  • page hierarchies
  • creates spaces locally when necessary
  • optional full sync refresh
  • real time feedback through progress bars and text logs
• Page Copy allows you to send selected pages and their attachments to another server with a coupld of clicks
• HTML export of pages to you local file system (new in v0.4.0)

Screenshots:

roadrunner screenshots

Current Limitations

• Space synchronization is currently one way from the remote server down to your local, though you CAN send content back up with the Page Copy feature.
• Content not currently copied down from the remote server
  • comments
  • labels
  • content entity data used by some macros such as voting macros
• document and page authorship data
• page histories are not copied if there were multiple updates between your syncronizations
  (there are many more limitations)

Features Roadmap

For version 0.5

• more intelligent tree rendering of just spaces until the space nodes are expanded to get pages
• "max size for attachments to copy" preference setting setting

More planned features

• support for SSL
• detect renamed pages rather than recreating
• available as a Confluence plugin
• synchronization history
• synchronization of labels and other additional metadata
• one touch two way synchronization so all local changes are uploaded to remote server(s)

F.A.Q.

Will it delete pages or other content

No. For the foreseeable future RoadRunneronly adds content. Even if something is removed on a remote server if it already existed on your local server it will not be removed. Additionally when pages and attachments are copied Confluence retains older versions of pages and attachments which are easily accessible.

I received a 'java.lang.OutOfMemoryError: Java heap space'

Please try increasing the memory by running it with this command:

java -Xms512m -Xmx512m -jar rr.jar

Or you can use this batch file from the same location as the jar (Windows).

This happened because attachments you were copying were big enough that it caused it to run out of memory. Running it this way will probably fix the problem. If not then when I add the WebDAV option it will definitely eliminate this issue.