---
title: "Configuring an external renderer"
canonical: "https://support.appfire.com/space/LM/77038344/Configuring%20an%20external%20renderer"
format: markdown
---
> Macro (aura-html)

<span style="color: #000000">When</span><span style="color: #000000"> installing LaTeX Math and/or deciding to use the external renderer for the first time, you must ensure that LaTeX Math can access the correct executables. </span>

### <span style="color: #000000">Installing LaTeX in Windows</span>

1. <span style="color: #000000">Download the </span>[MiKTeX](http://miktex.org/download)<span style="color: #000000"> installer. Version 2.9 will be suitable for this purpose.</span>
2. <span style="color: #000000">Run the installer and be sure to set "Install missing packages on-the-fly" to Yes.</span>
3. <span style="color: #000000">Ensure that LaTeX Math can find the executables by doing one of the following:</span>
  1. <span style="color: #000000">Restart Confluence to update the system path (recommended)</span>
  2. <span style="color: #000000">Or add the full path to the executables in LaTeX Math settings (e.g. C:\Program Files\MiKTeX\bin\latex.exe)</span>

### <span style="color: #000000">Installing LaTeX in Linux (Ubuntu)</span>

1. <span style="color: #000000">Run sudo apt-get install texlive dvipng preview-latex-style</span>

### <span style="color: #000000">Installing LaTeX in Linux (RHEL)</span>

1. <span style="color: #000000">Run sudo yum install texlive emacs-auctex</span>

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

<span style="color: #000000">If you encounter macro render errors related to missing pages, you should ensure that the following latex packages are installed. This applies to both Windows and Linux:</span>

- <span style="color: #000000">preview</span>
- <span style="color: #000000">dvipng</span>
- <span style="color: #000000">lh</span>
- <span style="color: #000000">cyrillic</span>
- <span style="color: #000000">cbfonts</span>
- <span style="color: #000000">greek-fontenc</span>
- <span style="color: #000000">cm-super</span>
- <span style="color: #000000">lm</span>
- <span style="color: #000000">eurosym</span>
- <span style="color: #000000">mathtools</span>
- <span style="color: #000000">standalone</span>
- <span style="color: #000000">dvisvgm</span>
- <span style="color: #000000">xkeyval</span>

### More <span style="color: #000000">information</span>

<span style="color: #000000">After following the above instructions, you can may wish to alter the LaTeX header and footer in LaTeX Math settings to use additional packages or otherwise alter the way LaTeX is rendered. The default settings will be appropriate for most users. Packages referred to in the header must be available on the server that Confluence is installed on.</span>

<span style="color: #000000">For Data Center instances of Confluence, please ensure the above software and packages are installed on each node.</span>