This container aims to generate doxygen documentation automatically. It works best when using a git hook to make a curl request to a specific url to this container. Once the get request is received, Doxygen's html documentation will be updated and hosted on this container using Nginx.

$ docker run --name doxygen-project-name -v /some/path/:/var/data/ -e GIT_REPO=https://git_url -p 8000:80 mart123p/docker-doxygen

This is the minimum to run the container. However, there are many more parameters to configure to the container. They are all listed below.

You may want to connect to git via ssh. In order to do so, you will need to have an ssh key pair. This container will automatically generate a public/private key for you. You can find the public key used for ssh authentication in the following path config/id_rsa.pub (config/id_rsa for the private key).

If you want to use your own ssh keys you can replace the two files with your own. You have to make sure that the permissions of your new ssh keys are the same as the original.

In order to launch automatically the generation of Doxygen's documentation you must set up a git hook. It should be a git hook post-receive on the git server. You can do something similar with github and it does not require scripting .

Inside the git hook, you will need to make a get request to the following url.

http://localhost:8000/cgi/hook.cgi?key=API_KEY

Please note, basic auth is not enabled on this url as it already needs a key to be accessed.