Manual install instructions?

[netchild]

Hi,

the docker container / yaml is not an install instruction. What about those people which want to give your code a try on other systems than what you provide with docker (e.g. *BSD or OS X)? Or about people which worry about supply chain attacks and prefer to give your code a try in a VM instead of blindly trusting docker? I'm not talking about a full installation guide, a list of software to install and pointers to an example config (maybe the one you use inside docker) for each component would already be great. Some info for someone who is used to build and install e.g. mysql or php by hand, or some info for someone who builds packages for an OS distribution (info which someone can use to create a RPM or dep or any other kind of OS package).

[gehaxelt]

Hi,
hm, we decided to use Docker to abstract away from distro-specific setups and their different configuration philosophies, but I do acknowledge your argument against just providing docker containers.

I'll keep the issue open and put that on my TODO list, but it might not be before March that I get around to actually document this :-(

In general, you'd need the following things:

• Webserver with support for PHP
• PHP with uopz, pcov and xdebug extension; configured as done in the web container (web/instrumentation/)
• Database or other dependencies as needed by your web app
• The shared volume paths would require creation and adjustments in the fuzzer + web containers to match
• Python3 for fuzzer with the packages from the requirements.txt
• File / Directory paths would likely need adjustments, since some are assumed to be at specific locations inside the containers right now.

=> Although the Dockerfile / docker-compose.yml are not install instructions, I believe much of the needed configuration is covered by them.