Version 1 (modified by Cas, 8 years ago) (diff)

new wiki page


Deluge won't start! What should I do?

Sometimes Deluge's settings get corrupted and need to be reset. See: Reset Settings

Otherwise see Bug Reporting

Deluge won't start with ImportError: No module named libtorrent

You need to install libtorrent-rasterbar

Deluge won't start with a gobject.GError: Unrecognised image file format error.

You need to install SVG support. On Debian/Ubuntu, the package is librsvg2-common.

Deluge's GTK UI won't connect to a remote daemon

Make sure both the GTK UI and the daemon are the same (or similar, e.g. 1.3.x) versions.

Otherwise make sure you've followed the thin client userguide.

Deluge isn't working! What should I do?

See Bug Reporting

If you are pasting the log on the forums, please use the [code][/code] tags.

If you are pasting the log on IRC, please use dpaste or pastebin or something similar.

How do I add an already completed torrent to Deluge?

If you add an already completed torrent to Deluge, you just need to set Download Location to the path where your data is, and Deluge will continue downloading/seeding the torrent.

A common error occurs if your torrent contained a folder. If your torrent contained a folder called Torrent.Name.2010, such that the data was in ~/downloads/Torrent.Name.2010/ You need to set the download location to ~/downloads/ not ~/downloads/Torrent.Name.2010/

If you have already added the torrent to Deluge, you can pause it, select 'Move Storage', point it to your data, then choose 'Force Re-check'

Torrent stuck at 99% or some other point, even though seeders available

Check that local machine firewall or router is not detecting a SYN flood and blocking packets. As a torrent reaches completion and you become a seeder, there can be a sudden inrush of connections from other peers that causes firewalls to start blocking. If so, try reducing the total connections allowed in Deluge, or increasing the tolerance on the router, or turning off SYN flood detection. Also check local storage for the downloaded file is not out of space (shown on bottom status bar in Deluge UI).

Windows Specific

Deluge doesn't start

Install Visual C++ 2008 SP1 Redistributable Package (x86).

Also applies to Error:14001 side-by-side configuration

Samba Network Shares

To use a Samba share in Deluge from within Windows, the share has to be mapped to a drive letter.

How can I change Deluge language?

There is a bug in the way GTK sets language on Windows but there are several workarounds:

  • Set a global LANG environment variable to the language you require, e.g. en.

  • Create a cmd file to set the LANG and open deluge. Copy the following text into notepad:
    set lang=en
    start deluge.exe
    Save the file as Deluge.cmd in the same folder as Deluge.exe. Create a shortcut to the .cmd file and use it to start Deluge.
  • To use only English, delete the following language files from Deluge program folder:

C:\Program Files\Deluge\deluge-1.3.x-py2.x.egg\deluge\i18n
C:\Program Files\Deluge\share\locale

Deluge Version

GTKUI: Help|About

From the terminal use --version e.g. deluged --version

libtorrent version

See Troubleshooting or alternatively from terminal:

python -c "from deluge._libtorrent import lt; print lt.version"

Python Version

From terminal: python --version


If you used a Deluge installer with python 2.7 (such as deluge-1.3.11-win32-py2.7-setup.exe), then use the egg with name ending with py2.7.egg). Else, use py2.6.egg.

Also you can check the Deluge installed files: %ProgramFiles%\Deluge\deluge-***-py2.7.egg This would signify Deluge is running Python 2.7.


For the the default Python version is 2.7.

Enable Deluge Logging

To enable logging run Deluge from a terminal with the following options.

  • These options apply to all Deluge applications: deluged, deluge-gtk, deluge-web & deluge-console

Logging to shell

deluge -L <loglevel>

Logging to file

deluge -L <loglevel> -l <logfile>

Available Log levels

  • none
  • critical
  • error
  • warning
  • info
  • debug

Note: debug is very verbose and with a lot of torrents log files will be MB's in size.

Windows Specific Logging

It is recommended to use the *.debug.exe to view errors that may be propagated to console and missed by logging.

e.g. from cmd or powershell run:

"%ProgramFiles%\Deluge\deluge-debug.exe" -L ERROR -l "%UserProfile%\Desktop\deluge.log"