Changes between Version 131 and Version 132 of Faq


Ignore:
Timestamp:
04/25/2010 12:51:50 AM (13 years ago)
Author:
Cas
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Faq

    v131 v132  
    1 [[PageOutline(1-2,Deluge 1.2 FAQ,inline)]] 
    2  
     1{{{ 
     2#!html 
     3<h1 style="text-align: left;">Deluge 1.2 FAQ</h1> 
     4}}} 
     5[[PageOutline(1-2,,inline)]] 
     6 
     7[[BR]] 
    38= General = 
    49 
     
    1318deluge 
    1419}}} 
    15 or 
     20''or'' 
    1621{{{ 
    1722deluge-gtk 
     
    2934}}} 
    3035 
    31 Go to http://localhost:8112/ 
    32 default-password = "deluge" 
    33  
    34 == Where does Deluge store its settings? == 
     36 From your browser go to http://localhost:8112/ default-password = "deluge" 
     37 
     38== Where does Deluge store its settings/config? == 
    3539 
    3640=== Linux === 
     
    4650}}} 
    4751 
    48 == How do I restore all settings to default? == 
     52== Where does Deluge store the .torrent files? == 
     53 
     54In a directory named '''`state`''' located within the Deluge config directory outlined above. 
     55 
     56== How do I reset the settings back to default? == 
    4957 
    5058If you don't care about losing your current torrents then delete everything in Deluge's settings folder (see above for location). 
     
    5260If you do want to keep your current torrents then delete everything except for the state folder. 
    5361 
     62[[BR]] 
    5463= Bittorrent = 
    5564 
     
    8695||Maximum Half-Open Connections||4|| 
    8796 
    88 You can then tweak those settings to suit your connection.  See [wiki:UserGuide/BandwidthTweaking BandwidthTweaking]. 
     97You can then tweak those settings to suit your connection.  See [wiki:UserGuide/BandwidthTweaking Bandwidth Tweaking]. 
    8998 
    9099Note: if you do not know your upload speed, go to http://speedtest.net and run a test. You can view the results in KB/s by choosing "kilobytes" for "Speed Measurement" which can be accessed under "Settings" in the top left corner of the page. 
     
    93102 
    94103 
    95 == Deluge sometimes creates files that I didn't ask it to download. Why? == 
     104== Deluge sometimes creates files that I didn't ask it to download? == 
    96105 
    97106Deluge handles files as pieces, not as individual files. This gets tricky, as sometimes the same piece is shared between multiple files. So if you tell Deluge to download a file, it'll download all of the pieces within that file, and if one of those pieces is shared with another file, that file will also be created, although not necessarily entirely downloaded. 
    98107 
    99 == I lost data on force recheck, Why? == 
     108== I lost data on force recheck? == 
    100109 
    101110Force recheck discards all incomplete pieces. 
     
    111120== Does Deluge support multi-tracker torrents? == 
    112121 
    113 Yes it does. Also, you can edit the trackers associated with a torrent by right-clicking on a torrent within Deluge, and clicking on “Edit Trackers.” 
     122Yes it does. You can edit the trackers associated with a torrent by right-clicking on a torrent within Deluge, and clicking on “Edit Trackers.” 
    114123 
    115124== What is the difference between full allocation and compact allocation? == 
     
    123132== Selective downloading isn't working. How come? == 
    124133 
    125 Selective downloading requires full allocation. [[BR]] 
    126 Make sure that you are not using compact allocation. [[BR]] 
    127 See above for an explanation between the two. 
     134Selective downloading requires full allocation, check you are not using compact allocation. See above for details between the two. 
    128135 
    129136== Which ports should I use? == 
     
    133140== Deluge uses random ports instead of selected one, why? == 
    134141 
    135 Click Apply after changing the port. 
    136  
    137 Deluge will pick a random port if the chosen port is not available.  
     142Click Apply after changing the port. Deluge will pick a random port if the chosen port is not available.  
    138143 
    139144Run "netstat" to check if the port is free. 
     
    159164== What is a magnet uri, and how do I get Deluge to handle them? == 
    160165 
    161 Magnet URIs are an easy way to add torrents by their info-hash.  You can learn more about them here: http://en.wikipedia.org/wiki/Magnet_URI_scheme 
     166Magnet URIs are an easy way to add torrents by their info-hash.  You can learn more about them [http://en.wikipedia.org/wiki/Magnet_URI_scheme here]  
    162167 
    163168If you're using GNOME, then you can do these following commands to associate magnets with Deluge: 
     
    194199Yes. Enable the [wiki:BlocklistPlugin Blocklist Plugin] 
    195200 
     201[[BR]] 
    196202= Console = 
    197203 
    198 == How do I connect the console UI to a daemon on a non-default port ? == 
     204== How do I connect the console UI to a daemon on a non-default port? == 
    199205 
    200206{{{ 
     
    203209}}} 
    204210 
     211[[BR]] 
    205212= Daemon = 
    206213 
    207 == Why is deluge still listed in my task manager even after I close it ? == 
    208  
    209 You closed the UI, but you did not close the daemon. 
     214== Why is deluge still listed in my task manager even after I close it? == 
     215 
     216You closed only the UI, but you did not close the daemon. 
    210217Choose "Quit & Shutdown Daemon" to close both Daemon and GtkUI. 
    211218 
    212 == How do I only start the daemon ? == 
     219== How do I only start the daemon? == 
    213220 
    214221{{{ 
     
    216223}}} 
    217224 
    218 == How do I start the daemon with logging enabled ? == 
     225== How do I start the daemon with logging enabled? == 
    219226 
    220227=== Logging to console === 
     
    243250 
    244251 
    245 == How do I stop the daemon ? == 
     252== How do I stop the daemon? == 
    246253 
    247254{{{ 
     
    273280See above. 
    274281 
     282[[BR]] 
    275283= Web UI = 
    276284 
     
    278286 
    279287The default password for the web interface is "deluge". You should change this upon first login for security reasons. 
    280  
    281 == How do I use https? == 
    282  
    283 === 1.1 and newer === 
    284  
    285  1. Create (self-signed) ssl certificates: http://httpd.apache.org/docs/2.0/ssl/ssl_faq.html#selfcert 
    286  
    287  ==== Windows ==== 
    288  
    289  1. Put deluge.cert.pem and deluge.key.pem in %APPDATA%\deluge\ssl\ 
    290  
    291  ==== Linux ==== 
    292  
    293  1. Put deluge.cert.pem and deluge.key.pem in ~/.config/deluge/ssl/ 
    294  
    295  ==== ALL ==== 
    296  
    297  1. Enable https in the webui config. 
    298  1. Restart the webui 
    299  
    300 == Can I bind the webui to port :80 in Linux? == 
    301 You cannot bind to anything under 1024 in linux, however if you have kernel 2.6.24 or higher, you can use capabilities to allow python to bind to port 80 securely. In debian/ubuntu: 
    302  
    303  1. sudo apt-get install libcap2-bin 
    304  1. sudo setcap 'cap_net_bind_service=+ep' /path/to/python 
    305  1. Configure the WebUI to use port 80 
    306  1. Restart deluged daemon. 
    307288 
    308289== How do I change the password? == 
     
    313294 1. Click "Change" 
    314295 
     296== How do I use https? == 
     297 
     298 1. Create (self-signed) ssl certificates: http://httpd.apache.org/docs/2.0/ssl/ssl_faq.html#selfcert 
     299 
     300 === Linux === 
     301 
     302 1. Put deluge.cert.pem and deluge.key.pem in ~/.config/deluge/ssl/ 
     303 
     304 === Windows === 
     305 
     306 1. Put deluge.cert.pem and deluge.key.pem in %APPDATA%\deluge\ssl\ 
     307 
     308 === ALL === 
     309 
     310 1. Enable https in the webui config. 
     311 1. Restart the webui 
     312 
     313== Can I bind the webui to port :80 in Linux? == 
     314You cannot bind to anything under 1024 in linux, however if you have kernel 2.6.24 or higher, you can use capabilities to allow python to bind to port 80 securely. In debian/ubuntu: 
     315 
     316 1. sudo apt-get install libcap2-bin 
     317 1. sudo setcap 'cap_net_bind_service=+ep' /path/to/python 
     318 1. Configure the WebUI to use port 80 
     319 1. Restart deluged daemon. 
     320 
     321 
     322[[BR]] 
    315323= Installing = 
    316324 
    317 == How do I install Deluge ? == 
     325== How do I install Deluge? == 
    318326 
    319327['Installing'] 
     
    321329== Does Deluge have its own repository? == 
    322330 
    323 There is an unofficial Ubuntu repository hosted at launchpad: https://launchpad.net/~deluge-team/+archive/ppa 
    324  
    325 It takes a few days for the latest version to be put up there. 
     331There is an unofficial Ubuntu repository hosted at launchpad: [http://dev.deluge-torrent.org/wiki/Installing/Linux/Ubuntu More Info] 
    326332 
    327333== How do I set Deluge as my default !BitTorrent program? == 
     
    329335On Windows, the installer should do this automatically. On Linux/Unix (GNOME), right-click on a torrent file, click on properties, click on the "open with" tab. Is deluge listed there? If so, select it to be your default, if not, click on "add", then click on "use custom command". Insert /usr/bin/deluge and click add. 
    330336 
    331 = Windows = 
     337[[BR]] 
     338 
     339= Troubleshooting = 
     340 
     341== Deluge won't start! What should I do? == 
     342 
     343Sometimes deluge's settings get corrupted and need to be reset. See: [wiki:Faq#HowdoIrestoreallsettingstodefault Reset Settings] 
     344 
     345== Deluge won't start with a "!ImportError: No module named pkg_resources" error. == 
     346 
     347You need to install setuptools. 
     348 
     349== Deluge won't start with a "!ImportError: No module named libtorrent" error. == 
     350 
     351You need to install [http://www.rasterbar.com/products/libtorrent/ libtorrent-rasterbar] 
     352 
     353== Deluge won't start with a “gobject.GError: Unrecognised image file format” error. == 
     354 
     355You need to install SVG support. On Debian/Ubuntu, the package is librsvg2-common. 
     356 
     357== Deluge's GTK UI won't connect to a remote daemon == 
     358 
     359Make sure both the GTK UI and the daemon are the same (or similar) versions. 
     360 
     361Deluge 1.2 was a complete rewrite and hence is unable to connect to 1.1.x 
     362 
     363Otherwise make sure you've followed the [wiki:UserGuide/ThinClient thin client userguide]. 
     364 
     365== Deluge isn't working! What should I do? == 
     366 
     367The best thing is to provide us with a debug log of deluged and/or deluge (depending if the error is related to the daemon and/or to a UI). 
     368 
     369{{{ 
     370#!comment 
     371 This is currently not the case. 
     372~~If you are on Windows, the debug logs are located in your [wiki:Faq#WheredoesDelugestoreitssettings settings folder] under the names "deluged.log" and "deluge.log".~~ 
     373}}} 
     374If you are in Linux, see [wiki:Faq#EnableDelugeLogging Enable Deluge Logging] below 
     375 
     376If you are pasting the log on the forums, please use the [code]![/code] tags. 
     377 
     378If you are pasting the log on IRC, please use [http://dpaste.com dpaste] or [http://pastebin.com pastebin] or something similar. 
     379 
     380= Troubleshooting on Windows = 
    332381 
    333382== Deluge doesn't start! == 
    334383 
    335 This is usually caused by a crufty GTK installation.  
    336  
    337 The solution: 
     384This is usually caused by a crufty GTK installation. This can be solved as follows: 
    338385 
    339386 * Uninstall the GTK2 Runtime 
     
    341388 * Reinstall GTK+ 
    342389 
    343 You can reinstall GTK by simply re-running the Deluge installer and selecting that option or download the latest from: http://download.deluge-torrent.org/windows/deps 
     390 Reinstall GTK by simply re-running the Deluge installer and selecting that option or download latest from our [http://download.deluge-torrent.org/windows/deps mirror] 
    344391 
    345392== Error: 14001 side-by-side configuration == 
    346393 
    347 This error is solved by installing the [http://www.microsoft.com/downloads/details.aspx?familyid=A5C84275-3B97-4AB7-A40D-3802B2AF5FC2&displaylang=en Microsoft Visual C++ 2008 SP1 Redistributable Package (x86)] 
     394This error is solved by installing the [http://www.microsoft.com/downloads/details.aspx?familyid=A5C84275-3B97-4AB7-A40D-3802B2AF5FC2&displaylang=en Visual C++ 2008 SP1 Redistributable Package (x86)] 
    348395 
    349396== Samba Network Shares == 
     
    351398In order for Deluge to use a Samba share from within Windows, the share has to be mapped to a drive letter. 
    352399 
    353 = Troubleshooting = 
    354  
    355 == Deluge won't start! What should I do? == 
    356  
    357 Sometimes deluge's settings get corrupted and need to be reset. 
    358  
    359 See [wiki:Faq#HowdoIrestoreallsettingstodefault] 
    360  
    361 == Deluge won't start with a "!ImportError: No module named pkg_resources" error. == 
    362  
    363 You need to install setuptools. 
    364  
    365 == Deluge won't start with a "!ImportError: No module named libtorrent" error. == 
    366  
    367 You need to install [http://www.rasterbar.com/products/libtorrent/ libtorrent-rasterbar] 
    368  
    369 == Deluge won't start with a “gobject.GError: Unrecognised image file format” error. == 
    370  
    371 You need to install SVG support. On Debian/Ubuntu, the package is librsvg2-common. 
    372  
    373 == Deluge's GTK UI won't connect to a remote daemon == 
    374  
    375 Make sure both the GTK UI and the daemon are the same (or similar) versions. 
    376  
    377 Deluge 1.2 was a complete rewrite and hence is unable to connect to 1.1.x 
    378  
    379 Otherwise make sure you've followed the [wiki:UserGuide/ThinClient thin client userguide]. 
    380  
    381 == Deluge isn't working! What should I do? == 
    382  
    383 The best thing is to provide us with a debug log of deluged and/or deluge (depending if the error seems to be related to the daemon and/or to a UI). 
    384  
    385 If you are on Windows, the debug logs are located in your [wiki:Faq#WheredoesDelugestoreitssettings settings folder] under the names "deluged.log" and "deluge.log". 
    386  
    387 If you are in Linux, see [wiki:Faq#EnableDelugeLogging Enable Deluge Logging] below 
    388  
    389 If you are pasting the log on the forums, please use the [code]![/code] tags. 
    390  
    391 If you are pasting the log on IRC, please use http://dpaste.com or http://pastebin.com or something similar. 
    392  
    393 == Enable Deluge Logging == 
     400= Enable Deluge Logging = 
    394401To enable logging run deluge from a shell with the following options. 
    395402These also apply to [wiki:Faq#HowdoIstartthedaemonwithloggingenabled deluged], deluge-gtk, deluge-web & deluge-console