Skip to content

Before Reporting a Bug

Search for Existing Issues

Frequently questions from users often relate to already fixed or known about bugs in Deluge so please search before asking.

Ask your Question Effectively

Two links that provide helpful generic tips for reporting software problems.

How To Ask Questions The Smart Way

How to Report Bugs Effectively

Collect Bug Information

You will need the following information when reporting a bug, Deluge and libtorrent versions are essential:

  • Version Information:

  • Deluge version.

  • libtorrent version.
  • Operating System and version.

  • Browser and version (if using WebUI).

  • Plugins enabled.

  • Language in use (if not in English).

  • Installation method i.e. from source, package or installer.

  • Precise steps to reproduce the bug.

  • Deluge Logs (error level is usually fine in first instance).

  • Information of any errors or traces.
  • Config files.
  • Screenshots and screencasts are helpful for GUI issues.

Note: If you are using Client and Daemon you may need version or logs from both.

Hard Crashes of Deluge (or libtorrent)

A backtrace using gdb may be required for hard crashes of Deluge (crashes without an obvious error in Deluge logs).

Here is a deluged example:

   gdb --args python /usr/bin/deluged -d
   (gdb) run
   ## After Crash ##
   (gdb) thread apply all backtrace

Opening a Bug Ticket

The bug ticket system we use is called Trac. [/register Sign up] if you haven't already.

Note: The Trac user account is separate to the Forum user account.

  1. [/newticket Create a new bug ticket]
  2. Fill in the boxes, making sure the following are completed:
  3. Summary: Short description of issue
  4. Description: Include the steps to reproduce and other collected information, use {{{ }}} markup for pasting code or errors.
  5. Version: Deluge version
  6. Component: Best guess as to where the problem occurs
  7. Attach any logs, screenshots or patches

External bug trackers

These sites also track bugs relating to Deluge or libtorrent.

libtorrent (rasterbar) Bugs: