---
title: "Install data center"
canonical: "https://support.appfire.com/space/GVIZ/70222431/Install%20data%20center"
format: markdown
---
> Macro (aura-html)


# <span style="color: #000000">Description</span>

<span style="color: #000000">The Confluence server must have the </span>[Graph Visualization Software](http://www.graphviz.org/)<span style="color: #404040"> </span><span style="color: #000000">(Graphviz) package installed for the</span><span style="color: #404040"> </span>[<span style="color: #404040">Graphviz Diagrams for Confluence</span>](https://appfire.atlassian.net/wiki/spaces/GVIZ/overview)<span style="color: #404040"> </span><span style="color: #000000">macros to work. The Graphviz package is free and supports a variety of operating systems including those supported by Confluence. </span>

> ✅ **Test your Graphviz installation**
> ✅ 
> ✅ <span style="color: #000000">After you have installed Graphviz, make sure the </span>*<span style="color: #000000">dot</span>*<span style="color: #000000"> executable is run from a command line using the same environment (especially, </span>*<span style="color: #000000">path</span>*<span style="color: #000000">) used to startup Confluence.</span>
> ✅ 
> ✅ <span style="color: #000000">If Confluence cannot find the executable, macro errors are shown in Confluence like - </span>**<span style="color: #000000">No useable executable name defined in graphviz.properties</span>****<span style="color: #000000">...</span>**<span style="color: #000000">.</span>

# <span style="color: #000000">Downloading Graphviz</span>

<span style="color: #000000">Before you can use</span> [<span style="color: #404040">Graphviz Diagrams for Confluence</span>](https://appfire.atlassian.net/wiki/spaces/GVIZ/overview)<span style="color: #000000">, </span><span style="color: #000000"> you must download and install</span> [Graph Visualization Software](http://www.graphviz.org/)<span style="color: #404040"> </span><span style="color: #000000">(Graphviz) on the system where you are running Confluence. Download the correct version of the software that matches your environment.  You can find the available versions on the</span><span style="color: #404040"> </span>[<span style="color: #404040">Graphviz Downloads</span>](http://www.graphviz.org/download/)<span style="color: #404040"> </span><span style="color: #000000">page.  Once the download is complete, follow the instructions given below for your operating system. </span>

# <span style="color: #000000">Graphviz on Windows</span>

1. <span style="color: #000000">Download the installer from this</span> [link](https://graphviz.gitlab.io/_pages/Download/Download_windows.html).
2. <span style="color: #000000">The default installation path is: </span>***<span style="color: #000000">C:\Program Files (x86)\Graphviz</span>***<span style="color: #000000">X.XX</span>***<span style="color: #000000">\bin</span>***<span style="color: #000000"> (Example: Graphviz</span>**<span style="color: #000000">X.XX</span>**<span style="color: #000000"> → Graphviz </span>**<span style="color: #000000">2.38</span>**<span style="color: #000000">)</span>
3. <span style="color: #000000">Open command line window as administrator and go the location </span>***<span style="color: #000000">C:\Program Files (x86)\Graphviz</span>***<span style="color: #000000">X.XX</span>***<span style="color: #000000">\bin</span>***<span style="color: #000000"> and run the following command:</span>
4. <span style="color: #000000">Exit the command line window.</span>
5. <span style="color: #000000">Go to </span>***<span style="color: #000000">Control Panel >  System and Security > System</span>***<span style="color: #000000">, and on the right side navigation panel, click the </span><span style="color: #000000">*Advanced systems settings*</span><span style="color: #000000"> link.</span>
6. <span style="color: #000000">In Advance settings, a dialogue box opens that shows the </span>**<span style="color: #000000">Environment Variables</span>**<span style="color: #000000"> </span><span style="color: #000000">button</span><span style="color: #000000">. Click the button.</span>
7. > Macro (anchor)

<span style="color: #000000">Select the entry </span>*<span style="color: #000000">Path</span>*<span style="color: #000000"> in the system variables section and add </span>***<span style="color: #000000">C:\Program Files (x86)\Graphviz</span>***<span style="color: #000000">X.XX</span>***<span style="color: #000000">\bin</span>***<span style="color: #000000"> to the existing path. </span><span style="color: #000000">Please see the below screenshot for</span><span style="color: #172B4D"> reference.</span>  
> Macro (inline-media-image)

> Macro (inline-media-image)
8. <span style="color: #000000">Click </span>**<span style="color: #000000">OK</span>**<span style="color: #000000">.</span><span style="color: #000000"> </span>
9. <span style="color: #000000"> Restart Confluence from a new command line window.</span>
10. <span style="color: #000000">Go to the System information page in your Confluence instance.</span>
11. <span style="color: #000000">Verify if you can see </span>***<span style="color: #000000">C:\Program Files (x86)\Graphviz</span>***<span style="color: #000000">X.XX</span>***<span style="color: #000000">\bin</span>***<span style="color: #000000"> in the </span>*<span style="color: #000000">Path</span>*<span style="color: #000000"> attribute on the page. </span><span style="color: #000000">If the path is available, that means that the configuration changes are successful. </span>
12. <span style="color: #000000">Go the page where you have used the macro and verify if the apps work.</span>
13. <span style="color: #000000">Restart Confluence.</span>
14. <span style="color: #000000">Verify the app works by creating a page with a simple </span>*<span style="color: #000000">flowchart</span>*<span style="color: #000000"> macro such as:</span>

# <span style="color: #000000">Graphviz on Windows for v2.38 or later</span>

<span style="color: #000000">In the Graphviz download</span> [link](https://graphviz.gitlab.io/download/)<span style="color: #000000">, it shows 2.38 as the latest version, but as of today, 2.43.x is the latest version for Windows. Graphviz team intends to make it available on the web as per</span> [this reference](https://gitlab.com/graphviz/graphviz/-/issues/1706#note_337386242) <span style="color: #000000">and</span> [this other](https://gitlab.com/graphviz/graphviz/-/issues/1706#note_337545473) <span style="color: #000000">reference.</span>

1. <span style="color: #000000">As per Graphviz team's suggestion, use the latest executable and missing config, that is,</span> [graphviz-2.43](https://appfire.atlassian.net/wiki/pages/viewpageattachments.action?pageId=70222431) <span style="color: #000000">file available on their page.</span>
2. <span style="color: #000000">You must install the </span>*<span style="color: #000000">.exe</span>*<span style="color: #000000"> and copy the </span>*<span style="color: #000000">config6</span>*<span style="color: #000000"> file in the </span>***<span style="color: #000000">bin</span>***<span style="color: #000000"> folder after successful installation. Note that if </span>*<span style="color: #000000">config6</span>*<span style="color: #000000"> file is comes with installation, you can skip copying it manually to the </span>***<span style="color: #000000">bin</span>***<span style="color: #000000"> folder.</span>
3. <span style="color: #000000">After the installation is complete, follow the steps 7-15 mentioned in the</span> previous section <span style="color: #000000">with the latest 2.43.x version of Graphviz.</span>
4. <span style="color: #000000">Check with</span>**<span style="color: #000000"> </span>**`dot -V`<span style="color: #000000"> at the command prompt whether your changes are reflected.</span>

> ⚠️ <span style="color: #000000">Due to some performance issues with 2.38 version of the Graphviz for Windows, this section has been added temporarily until the latest version installation instructions are made available on Graphviz</span> [Downloads](https://graphviz.gitlab.io/download/)<span style="color: #000000"> location.</span>

# <span style="color: #000000">Graphviz on Mac OSX</span>

1. <span style="color: #000000">Follow the instructions mentioned</span> [here](http://macappstore.org/graphviz/)<span style="color: #000000">.</span>
2. <span style="color: #000000">The installer usually sets up everything so that the </span>*<span style="color: #000000">dot</span>*<span style="color: #000000"> appears under the </span>*<span style="color: #000000">Path</span>*<span style="color: #000000"> variable.</span>

# <span style="color: #000000">Graphviz on Linux and Unix</span>

1. <span style="color: #000000">Install the </span>*<span style="color: #000000">graphviz.rpm</span>*<span style="color: #000000">, the </span>*<span style="color: #000000">graphviz-graphs.rpm</span>*<span style="color: #000000">, and the </span>*<span style="color: #000000">graphviz-gd.rpm</span>*<span style="color: #000000"> packages.</span>
2. <span style="color: #000000">Open the directory where Graphviz is installed and confirm the path.</span>
3. <span style="color: #000000">Log in as the user who runs Confluence or starts Confluence.</span>
4. <span style="color: #000000">Append the path to the </span>***<span style="color: #000000">bin</span>***<span style="color: #000000"> directory of Graphviz to the </span>*<span style="color: #000000">Path</span>*<span style="color: #000000"> variable.</span>

# <span style="color: #000000">Graphviz on Ubuntu</span>

1. <span style="color: #000000">Install the Graphviz packages with the following set of commands: </span>

# <span style="color: #000000">Last resort</span>

<span style="color: #000000">The method mentioned in this section is not required and not recommended in most cases. Use this as an alternative if you are not able to set your </span>*<span style="color: #000000">path</span>*<span style="color: #000000"> correctly to find the </span>*<span style="color: #000000">dot</span>*<span style="color: #000000"> executable</span>.

> ℹ️ **If you get errors about not finding dot.exe**
> ℹ️ 
> ℹ️ 1. <span style="color: #000000">Download the app jar file.</span>
> ℹ️ 2. <span style="color: #000000">Unzip the jar to a temporary directory.</span>
> ℹ️ 3. <span style="color: #000000">Edit the </span>*<span style="color: #000000">graphviz.properties</span>*<span style="color: #000000"> file.</span>
> ℹ️   - <span style="color: #000000">Replace </span>*<span style="color: #000000">dot.candidate.paths</span>*<span style="color: #000000"> setting with something as (yes, use forward slashes </span>🙂<span style="color: #000000">):</span>
> ℹ️ 4. <span style="color: #000000">Zip all files in the temporary directory to create a new jar file.</span>
> ℹ️ 5. <span style="color: #000000">Uninstall the Graphviz app and re-install your customized version.</span>
> ℹ️ 6. <span style="color: #000000">GVIZ-1 makes this easier.</span>