Public Repository

Last pushed: a month ago
Short Description
Official Docker builds of FAF based on Fedora - Platform for collection and analysis of problems
Full Description

Supported tags and respective Dockerfile links

What is FAF?

FAF is a web service for aggregating and analyzing reports of unhandled crashes.
For users web pages are available containing reports, problems and statistics for finding out when, how and to whom application crashes.
The live instance can be found here.

What's in this image?

This image is built from the official Copr repository.
Also, the database is prepared and basic configuration is set to make it work out of the box.

Supported operating systems

This image is ready to accept reports from all active releases of Fedora.

To add a new version of the already supported system you run:
# docker exec -u faf faf faf releaseadd -o OPSYS --opsys-release RELEASE
E.g.: To add Fedora 99 you run:
# docker exec -u faf faf faf releaseadd -o fedora --opsys-release 99

You can even write a plugin for your own OS. Once you wrote this plugin and install it, you can enable it using:
docker exec -u faf faf faf opsysadd OPSYS

Quickstart

# docker run --name faf -dit abrt/faf-image

However you also probably want to mount volumes to /var/lib/postgres and to /var/spool/faf to have a persistent database and FAF's data.

# docker run --name faf -v /var/lib/faf-docker/faf:/var/spool/faf -v /var/lib/faf-docker/postgres:/var/lib/postgres/ -dit abrt/faf-image

If you run FAF for the first time, then there is no database. You have to initialize it.

# docker exec faf init_db

Then FAF is ready for use.

What's next

You can see incoming reports in webUI. It is accessible on http://<container_IP>/faf.

Finding out container IP address:
# docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' faf

Also to send reports into your own FAF, you have to set up a package libreport on all machines, from with you wish to report into your own FAF. To do so, open a file /etc/libreport/plugins/ureport.conf and enter here:

URL = http://<container_IP>/faf.

For servers you may want to enable automatic reports. Those reports are called μReport. Run:

# abrt-auto-reporting yes

Issues

If you have any problems with or questions about this image, please contact us
through a GitHub issue.

Contributing

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests and do our best to process
them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub
issue
, especially for more
ambitious contributions. This gives other contributors a chance to point you in
the right direction, give you feedback on your design and help you find out if
someone else is working on the same thing.

Documentation

Documentation for this image is available in the README.md file in the abrt/faf GitHub repo.

Docker Pull Command
Owner
abrt

Comments (0)