How to install Graphviz software

Description

The Confluence server must have the Graph Visualization Software (Graphviz) package installed in order for the Graphviz Plugin for Confluence macros to work. The Graphviz package is free and supports a variety of operating systems including those supported by Confluence. 

Graphviz on Windows

1. Download and run the Windows installer
   • Defaults to install in C:\Program Files\Graphviz2.16 or similar
   • Automatically adds this to your Windows path
   • Confirm that you can run dot.exe from a newly opened command line
2. Restart Confluence

3. Verify it works by creating a page with a simple flowchart macro like:

   {flowchart} 
   A -> B
   {flowchart}
   

   If you get errors about not finding dot.exe

   1. Download the plugin jar file
   2. Unzip the jar to a temporary directory
   3. Edit the graphviz.propertiesfile

      • Replace dot.candidate.paths setting with something like (yes, use forward slashes ):

        dot.candidate.paths=c:/PROGRA~1/Graphviz2.16/bin/dot.exe
        

   4. Zip all files in the temporary directory to create a new jar file
   5. Uninstall the graphviz plugin and re-install your customized version
   6. GVIZ-1 will make this easier

Graphviz on Mac OSX

1. Download and run the installer.

Graphviz on Linux and Unix

1. Install the graphviz.rpm, the graphviz-graphs.rpm, and the graphviz-gd.rpm packages
2. Open the directory GraphViz is installed under and confirm the path
3. Login as the user who runs Confluence or starts the Confluence service
4. Append the path to the bin directory of GraphViz to the 'Path' variable