Skip to content

Troubleshooting

This is a guide for common problems that may occur when working on piqtree development. If you have an issue that isn't listed here, please feel more than welcome to raise an issue and we'll look into it.

piqtree doesn't install

There could be several reasons piqtree doesn't install correctly.

Check your operating system is supported

At this stage, we currently only support x86-64 linux, x86-64 Windows, and ARM macOS.

Check the IQ-TREE library is up-to-date

Try running the following to build the latest version of the IQ-TREE library.

git submodule update --init --recursive
./build_tools/build_iqtree.sh

If the above doesn't work, please retry the guide on "Setting up your environment for development".

The IQ-TREE library doesn't build

There could be several reasons piqtree doesn't build.

Check your operating system is supported

At this stage, we currently only support x86-64 linux, x86-64 Windows, and ARM macOS.

Check dependencies have been installed

  • If on Windows, try running ./before_all_windows.sh which will also install dependencies.
  • If on macOS, try running ./before_all_mac.sh which will also install dependencies.
  • If on linux, try installing the dependencies listed at the top of .devcontainer/DockerFile