troubleshooting installation

Troubleshooting: Installation

Docker DNS Issue in Ubuntu 18.04.

At the moment docker cannot handle a local systemd-resolver as present in Ubuntu 18.04. If your machine has no access to the fallback DNS server 8.8.8.8 docker image creation will fail.
Solution: Follow this guide to deactivate the local systemd-resolver in ubuntu 18.04.

"Your Distribution is not supported" issue

If you use a compatible linux distribution and you get the following error, you need to upgrade your python distro package.

Your Distribution (ubuntu 18.04) is not supported. FACT Installer requires Ubuntu 16.04, Ubuntu 18.04 or compatible!

This command should fix the issue:

$ sudo -EH pip3 install --upgrade distro 

⚠️ If your distribution is not supported but you'd like to try anyway (most Debian based systems support FACT, even if we do not officially list them) you can either

• add your codename (see above: distro) in the src/install.py
• or replace the distro check by simply returning one of the valid strings (also in src/install.py) Typically if errors occur, it happens for docker or mongodb where we have to add download mirrors to the apt.sources.