WARNING: The obnam project was retired in 2017!

Read more here

This documentation is for reference use only, please use another backup solution instead.
Hint: Many users have migrated to restic.


This chapter discusses how to debug problems with Obnam. It covers things such as log files, various levels of logging and tracing, and common problems with Obnam use. It also explains what things go where in an Obnam backup repository.

Turning on full logging

Obnam can write a log file. There are several options controlling that. Knowing these can help get out the most information when there's a problem that needs to be investigated.

Note that these settings can make log files be quite large, in the order of tens of megabytes. The size depends on how many files and how much data your live data has.

Reporting problems ("bugs")

If you have a problem with Obnam, and you want to report it (please do!), including the following information is helpful and makes it easier to figure out what the problem is.

If you respond to messages on obnam-support, always keep the list in the cc list. This means others will see the response, and there's a chance that they can help you better than the particular person you're responding to. Also, the archived discussion may be helpful to later readers, perhaps years afterwards.

Thank you for your help in making Obnam better.