didierc/docker-darkstat repository overview

⁠Darkstat

Darkstat - https://unix4lyfe.org/darkstat/⁠

Before it was didierc/rpi-darkstat⁠

Running on the latest debian stable slim for amd64, armv6, armV7 and arm64 with darkstat from git repository on the master branch.

⁠Pull image

docker pull didierc/docker-darkstat

⁠Run container

docker run -d --net="host" --name=<container name> -v <local path to store db/log>:/darkstat/config -v /etc/localtime:/etc/localtime:ro -e OPTIONS=<options for darkstat> -e DS_UID=<uid> -e DS_GID=<gid> didierc/docker-darkstat

• OPTIONS = To see the list of options available for darkstat. Please check the website of darkstat. Or search "man darkstat" on the web
• DS_UID = uid for the user darkstat. Default is 1000
• DS_GID = gid for the user darkstat. Default is 1000

By default the user darkstat is created in the container and used by darkstat. And darkstat is launched in no deamon and with the chroot "/darkstat/config" to save log and database with the volume.

⁠Web-UI

http://<host ip>:[PORT]

⁠Example

docker run -d --net="host"  --name=darkstat -v /mylocal/directory/fordata:/darkstat/config -v /etc/localtime:/etc/localtime:ro -e OPTIONS="-i eth0 --daylog darkstat.log --verbose --import darkstat.db --export darkstat.db" didierc/docker-darkstat

⁠Database

⁠To export the database here the workaround.

• Get the PID of darkstat process

  pc >$ docker top <container id>
  

  Copy

• Send a SIGUSR1 or SIGUSR2 to the darkstat process

  pc >$ kill -10 13080
  

  Copy

⁠Build image multi-arch

Code available on Gitlab⁠

The image is build with docker buildx⁠

• Create the builder :

docker buildx create --platform linux/amd64,linux/arm64,linux/arm/v7,linux/arm/v6 --use

• Build and push the images

docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7,linux/arm/v6 --push -t didierc/docker-darkstat:latest .

⁠Improvements

• add an entrypoint to export the database with an SIGUSR1 signal like in the darkstat documentation.
• Delete the run.sh and make an entrypoint for the start to be always the PID 1