Yes, Deluge is Free Software, as defined by the Free Software Foundation, and is released under the GPL, giving our users complete freedom. The source code is available in the [download section](/download). Our GPL nature allows you to be 100% sure that our program will never “spy” on your activities. Closed-source BitTorrent clients cannot make that same claim.
## How do I install Deluge?
### How do I install Deluge?
['Installing']
[Installing](/installing)
## I have an issue starting or using Deluge.
### I have an issue starting or using Deluge.
See ['Troubleshooting'] and ['Bug Reporting'](/contributing/bugreporting)
See [Troubleshooting](/troubleshooting) and [Bug Reporting](/contributing/bugreporting)
## How to start the various user-interfaces?
See [UI specific questions](/faq#userinterfacespecific)
### How to start the various user-interfaces?
See [UI specific questions](/faq#user-interface-specific)
## How do I set Deluge as my default BitTorrent program?
### How do I set Deluge as my default BitTorrent program?
On 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.
## How do I set Deluge as my default program for Magnet URIs?
### How do I set Deluge as my default program for Magnet URIs?
* **GNOME** users can associate Magnets with Deluge with the following commands:
#### Gnome
Users can associate Magnets with Deluge with the following commands:
* Put `about:config` into address bar and change `network.protocol-handler.expose.magnet` to `false`.
You will be prompted next time you click a Magnet to set an association with Deluge. (e.g. `/usr/bin/deluge`)
* **Windows** users should simply re-run the installer and select the magnet association option.
* **OSX** GTK does not support Magnet URIs (see [#2420](/ticket/2420)) but there is a plugin available: http://forum.deluge-torrent.org/viewtopic.php?f=9&t=52619
## Where does Deluge store its settings/config?
### Where does Deluge store its settings/config?
The default location for the Deluge config directory is in the `home` directory of the current user. The config location can be manually changed by using the `--config` option at startup.
@ -56,19 +62,19 @@ The default location for the Deluge config directory is in the `home` directory
*When running Deluge as a service the config directory is relative to the user specified in the service configuration.*
## Where does Deluge store the .torrent files?
### Where does Deluge store the .torrent files?
Within the Deluge config in a directory named `state`.
## How do I reset the settings back to default?
### How do I reset the settings back to default?
If you don't care about losing your current torrents then delete everything in Deluge's [config](/faq#wheredoesdelugestoreitssettingsconfig) directory.
If you don't care about losing your current torrents then delete everything in Deluge's [config](/faq#where-does-deluge-store-its-settingsconfig) directory.
If you do want to keep your current torrents then delete everything except for the `state` folder.
# User Interface Specific
## GTK UI
### How do I start the GTK UI?
## User Interface Specific
### GTK UI
#### How do I start the GTK UI?
The main graphical interface. Can be started with either of the following:
```
@ -79,8 +85,8 @@ deluge
deluge-gtk
```
## Web UI
### How do I start the Web UI?
### Web UI
#### How do I start the Web UI?
The web interface enables access to Deluge from your browser.
There are two ways to enable this interface:
@ -94,38 +100,38 @@ deluge-web
Open the browser at `http://localhost:8112`.
### What is the default password
#### What is the default password
The Web UI default password is `deluge`.
For security you should change this upon first login.
### How do I change the password?
#### How do I change the password?
In the Web UI:
1. Click on `Preferences`.
2. Select the `Interface` category.
3. Fill out the fields under `Password`.
4. Click `Change` button.
### How can I reset forgotten password?
#### How can I reset forgotten password?
1. Stop the Web UI before modifying the `web.conf` file.
2. Edit `web.conf` in [config](/faq#wheredoesdelugestoreitssettingsconfig) and delete the entire `pwd_sha1` line or use quick method via command-line e.g.:
2. Edit `web.conf` in [config](/faq#where-does-deluge-store-its-settingsconfig) and delete the entire `pwd_sha1` line or use quick method via command-line e.g.:
```
sed -i.bak "/pwd_sha1/d" ~/.config/deluge/web.conf
```
3. Start the Web UI and the password will have been reset to default password `deluge`.
### How do I configure plugins with the Web UI?
#### How do I configure plugins with the Web UI?
Not all plugins are configurable directly with the Web UI, see [Plugins] table for those with Web UI code.
The easiest way to configure plugins is using the GTK UI. If unable to use GTK UI on the machine with your daemon, it is possible to connect to that daemon from another computer with the GTK UI. See [ThinClient](/userguide/thinclient) for more information on remote GTK UI setup.
### How do I auto-connect to a specific daemon?
#### How do I auto-connect to a specific daemon?
1. Stop the Web UI before modifying the `web.conf` file.
2. Edit `web.conf` in [config](/faq#wheredoesdelugestoreitssettingsconfig), find `"default_daemon"` and set its value to the daemon `id` in `hostlist.conf`
2. Edit `web.conf` in [config](/faq#where-does-deluge-store-its-settingsconfig), find `"default_daemon"` and set its value to the daemon `id` in `hostlist.conf`
e.g. To connect to localhost you would open `hostlist.conf` as see a snippet such as:
@ -143,25 +149,26 @@ The easiest way to configure plugins is using the GTK UI. If unable to use GTK U
```
1. Restart the Web UI.
### How do I enable HTTPS?
#### How do I enable HTTPS?
1. Create a (self-signed) SSL certificate: http://httpd.apache.org/docs/2.0/ssl/ssl_faq.html#selfcert
2. Put the resulting `deluge.crt` and `deluge.key` in the [config's](/faq#wheredoesdelugestoreitssettingsconfig) `ssl` directory.
2. Put the resulting `deluge.crt` and `deluge.key` in the [config's](/faq#where-does-deluge-store-its-settingsconfig) `ssl` directory.
3. Enable HTTPS in Web UI config and modify the filepaths to match the above files.
4. Restart the Web UI.
### Can I bind the Web UI to port 80 in Linux?
#### Can I bind the Web UI to port 80 in Linux?
You cannot bind to anything under 1024 in Linux, however with kernel >=2.6.24, you can use capabilities to allow Python to bind to port 80 securely.
*Note: Requires the Deluge daemon `deluged` to be running.*
The text-based interface, ideal for terminal use:
@ -176,7 +183,7 @@ The console can be also run in a non-interactive mode which outputs to the termi
deluge-console "info [torrent]"
```
### How can I run multiple commands from the terminal?
#### How can I run multiple commands from the terminal?
Use `;` to separate commands and enclose the commands with double quotes `"`:
@ -185,25 +192,25 @@ deluge-console "connect host user pass; info"
```
### How do I connect the console UI to a daemon on a non-default port?
#### How do I connect the console UI to a daemon on a non-default port?
```
$ deluge-console
>>> connect localhost 12345
```
### I encountered `BadLoginError("Password does not match")` with localhost daemon?
#### I encountered `BadLoginError("Password does not match")` with localhost daemon?
This is likely due to mismatching config locations, ensure you are running deluge-console with same user as deluged: [More Details](/userguide/thinclient#accessingdelugedservicewithlocaluiclient)
## Daemon
### Daemon
### Why is Deluge still listed in my task manager even after I close it?
#### Why is Deluge still listed in my task manager even after I close it?
You closed only the UI, but you did not close the daemon.
Choose "Quit & Shutdown Daemon" to close both Daemon and GTK UI.
### How do I start and stop the daemon?
#### How do I start and stop the daemon?
```
deluged
@ -215,9 +222,9 @@ pkill deluged
*Note: Deluge accepts the `SIGTERM` signal and cleanly shuts down.*
### How do I start the daemon with logging enabled?
#### How do I start the daemon with logging enabled?
### How do I make Deluge connect to a different daemon?
#### How do I make Deluge connect to a different daemon?
By default, Deluge (GTK UI) is in classic mode, the daemon and GTK UI are linked together.
To disable classic mode:
1. `Preferences` -> `Interface`
2. Disable (untick) `Classic Mode`
3. Restart Deluge and it will now start in thin-client mode
4. Use the Connection Manager to enter the other daemon details
5.
See [ThinClient](/userguide/thinclient) for more information on remote GTK UI
### How do I stop Deluge from killing the daemon when I quit the GTK UI?
#### How do I stop Deluge from killing the daemon when I quit the GTK UI?
See above.
# BitTorrent Related=
## BitTorrent Related
## The files tab shows a different percentage-completed than the torrent
### The files tab shows a different percentage-completed than the torrent
The files tab will only show percentages based on completed pieces while the main view will show total completed including incomplete pieces.
## What do all those numbers in parentheses mean?
### What do all those numbers in parentheses mean?
| | | |
|-----------|-------|---------|
| **Field** | **#** | **(#)** |
|-----------|-------|---------|
| Seeders | Number of connected seeders | Total number of seeders |
| Peers | Number of connected peers | Total number of peers |
| Downloaded | Total amount downloaded | Total amount downloaded this session |
| Uploaded | Total amount uploaded | Total amount uploaded this session |
## Seeding torrents have no queue position! Why?
### Seeding torrents have no queue position! Why?
Seeds use something called "seed rank" to determine which should be active and which should be queued. The seed rank is determined by the number of seed cycles a torrent has completed. Torrents with fewer completed seed cycles are prioritized for seeding. A seed cycle is completed when a torrent meets either the share ratio limit (uploaded bytes / downloaded bytes), the share time ratio (time seeding / time downloading) or seed time limit (time seeded).
## What bandwidth settings should I use?
### What bandwidth settings should I use?
Start with the following:
| | |
|-------------------|---|
|Maximum Connections|200|
@ -280,11 +290,13 @@ Start with the following:
|Maximum Connection Attempts per Second|20|
If you're using Windows XP*:
| | |
|-----------------------------|-|
|Maximum Half-Open Connections|8|
If you're using pre-SP2 Windows Vista*:
| | |
|-----------------------------|-|
|Maximum Half-Open Connections|4|
@ -296,31 +308,31 @@ Note: if you do not know your upload speed, go to http://speedtest.net and run a
* If you have Deluge setup as a [ThinClient](/userguide/thinclient) then this setting is determined by the OS the daemon is running on, not the thin client.
## Deluge sometimes creates files that I didn't ask it to download?
### Deluge sometimes creates files that I didn't ask it to download?
Deluge handles files as pieces, not as individual files. This gets tricky, as sometimes the same piece is shared between consecutive 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.
Note: Deluge can be run with experimental libtorrent from libtorrent_aio branch. In this case all pieces of not wanted files will be stored in one temporary file per torrent.
## I lost data on force recheck?
### I lost data on force recheck?
Force recheck discards all incomplete pieces.
## Does Deluge support Initial or Super Seed?
### Does Deluge support Initial or Super Seed?
Not yet, but it will be added in a future release, see [#1903](/ticket/1903).
## Does Deluge have an embedded tracker?
### Does Deluge have an embedded tracker?
No and it probably never will. We want to be the best BitTorrent client around, and to do that we need to focus on just being a client.
## Does Deluge support multi-tracker torrents?
### Does Deluge support multi-tracker torrents?
Yes it does. You can edit the trackers associated with a torrent by right-clicking on a torrent within Deluge, and clicking on “Edit Trackers.”
This conforms to the BitTorrent Multitracker [specifications](http://wiki.depthstrike.com/index.php/P2P:Protocol:Specifications:Multitracker)
## What is the difference between full allocation and compact allocation?
### What is the difference between full allocation and compact allocation?
Compact allocation only allocates as much storage as it needs to keep the pieces downloaded so far. This means that pieces will be moved around to be placed at their final position in the files while downloading (to make sure the completed download has all its pieces in the correct place). In full allocation, the entire space that a file needs is allocated as soon as one piece of that file is downloaded, thus decreasing fragmentation.
@ -328,21 +340,21 @@ We suggest that our users use full allocation.
Deluge uses [sparse files](http://en.wikipedia.org/wiki/Sparse_file) for full allocation, the compact allocation option is only useful on file systems that don't support sparse files (such as FAT or HFS+).
## Selective downloading isn't working. How come?
### Selective downloading isn't working. How come?
Selective downloading requires full allocation, check you are not using compact allocation. See above for details between the two.
## Which ports should I use?
### Which ports should I use?
The official ports for Bittorrent are `6881-6889`, but most ISPs block or at least throttle those ports, so users are encouraged to use a port range of something between `49152` and `65535`.
## Deluge uses random ports instead of selected one, why?
### Deluge uses random ports instead of selected one, why?
You will need to click OK or Apply in Preferences after changing the port however Deluge will pick a random port if the chosen port is not available.
Run `netstat` to check if the port is free.
## What does "Auto Managed" do?
### What does "Auto Managed" do?
An "auto managed" torrent, is a torrent managed by Deluge.
This means that it obeys Deluge's queue settings.
@ -351,7 +363,7 @@ It will still be be bound by the stop ratio though (see 'Stop seed at ratio' und
Note: All active torrents (including those not "auto managed") are counted in the total active queue settings. This means that if the total number of active torrents ("auto managed" and not) exceed the limit for total active torrents in the queue settings, Deluge will automatically queue any "auto managed" torrents until the limit is no longer exceeded.
## Does Deluge have an equivalent to "Force Start"?
### Does Deluge have an equivalent to "Force Start"?
Deluge has "auto managed" torrents which are similar, see above for details.
@ -360,23 +372,24 @@ To make a torrent no longer "auto managed":
2. Select the options tab.
3. Unselect "Auto Managed".
## What is a Magnet URI?
### What is a Magnet URI?
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).
## What is Peer TOS Byte?
### What is Peer TOS Byte?
IPv4 Header Type Of Service Byte [http://shorewall.net/manpages/shorewall-tcclasses.html (More Info)](http://shorewall.net/manpages/shorewall-tcclasses.html (More Info))
Masks: Normal Service `0x00`, Minimize Cost `0x02`, Maximize Reliability `0x04`, Maximize Throughput `0x08`, Minimize-delay `0x10`
## Can Deluge use blocklists such as SafePeer or PeerGuardian?
### Can Deluge use blocklists such as SafePeer or PeerGuardian?
You can use the [Blocklist Plugin](/plugins/blocklist).
## I have a status bar warning: "No Incoming Connections!"
### I have a status bar warning: "No Incoming Connections!"
You need to configure your router or firewall to allow (unblock) incoming torrent traffic for the network ports that Deluge uses.
Enabling `UPnP` in Deluge and on your router can automatically open the ports as needed.
@ -6,4 +6,4 @@ Download the latest installer from: [http://download.deluge-torrent.org/windows]
On Windows the installer installs a standalone application by default into `Program Files` and the bundle includes Python, GTK and all relevant dependencies. The only external requirement that may be not be installed on your system is the [Visual C++ 2008 SP1 Redistributable Package (x86)](http://www.microsoft.com/downloads/details.aspx?familyid=A5C84275-3B97-4AB7-A40D-3802B2AF5FC2&displaylang=en).
For the Deluge config location see: [Faq#WheredoesDelugestoreitssettingsconfig](/faq#wheredoesdelugestoreitssettingsconfig)
For the Deluge config location see: [Faq#where-does-deluge-store-its-settingsconfig](/faq#where-does-deluge-store-its-settingsconfig)
The daemon looks at the file [<config folder>](http://dev.deluge-torrent.org/wiki/Faq#WheredoesDelugestoreitssettingsconfig)/auth for doing authentication.
The daemon looks at the file [<config folder>](http://dev.deluge-torrent.org/wiki/Faq#where-does-deluge-store-its-settingsconfig)/auth for doing authentication.
The format of this file is straightforward, each line contains a username:password:level tuple in plaintext.
*Note: The config location is either the [default location](/faq#wheredoesdelugestoreitssettingsconfig) with reference to the `user` that `deluged` is running as. Alternatively if using a service it will be specified in the service config files with `-c <path>` option.*
*Note: The config location is either the [default location](/faq#where-does-deluge-store-its-settingsconfig) with reference to the `user` that `deluged` is running as. Alternatively if using a service it will be specified in the service config files with `-c <path>` option.*
Calum Lind