Troubleshooting
This is a list of common pitfalls on using StartLeft, and how to avoid them.
ImportError: failed to find libmagic.
When using Windows or OSX OS, there is the requirement to manually install the corresponding python-magic library as indicated in the prerequisites section.
"glightbox" package is not installed
When trying to launch StartLeft documentation by mkdocs serve using IntelliJ, you may get an
error stating that the glightbox package is not installed.
This requires re-running the pip install -r docs/requirements.txt
command and restarting the IDE.
Cannot open include file: 'graphviz/cgraph.h'
When using Windows, it is sometimes required to set up some extra configurations.
Install Graphviz in your OS using the following command:
Adding the Graphviz binaries to the PATH
Installing the pygraphviz lib setting the OS files location:
pip install --global-option=build_ext --global-option="-IC:\Program files\Graphviz\include" --global-option="-LC:\Program files\Graphviz\lib" pygraphviz
When on MacOS the pygraphviz compilation steps may fail because it can't find the graphviz headers.
First, make sure you have graphviz installed, for homebrew run:
Export the compilation flags to tell pip's build process where to find the headers:
export CFLAGS="-I $(brew --prefix graphviz)/include"
export LDFLAGS="-L $(brew --prefix graphviz)/lib"
You can now either try installing startleft (which will pull pygraphviz as a dependency) or install pygraphviz with pip install pygraphviz, in the same terminal.
pygraphviz/graphviz_wrap.c:154:11: fatal error: Python.h: No such file or directory
Looks like you haven't properly installed the header files and static libraries for python dev.
You need to add a PPA offered by the “deadsnakes” team to get the old archived Python versions easily.
After you need to install the required library for your python dev version: