Installation and Configuration
- Installation Dependencies
- Installation from PyPI (easy_install)
- Manual Installation
- Starting Downpour
- Stopping Downpour
Downpour is written in Python.
- Twisted 8.2.0+
- pysqlite2 (or sqlite3, bundled with python 2.5)
- Storm 0.14+
- Jinja 2
- libtorrent 0.14+
- feedparser 4.1+
- dateutil >= 1.4.1
Installation from PyPI (easy_install)
Downpour is available from PyPI, so if you use easy_install or pip, installation is as easy as running one of the following commands:
pip install Downpour
You will need to manually install libtorrent, since it is not available on PyPI. Most linux distributions have this packaged for you (python-libtorrent on Ubuntu).
After installation, create a configuration file in /etc/downpour.cfg (sample) and ensure that the directories listed in the config file are writable by the downpour user.
To install manually, download the source package and perform the following steps:
Verify that python-setuptools is installed
Unpack the source package into a local directory
Download and manually install libtorrent. Most linux distributions have this packaged for you (python-libtorrent on Ubuntu). Other dependencies will be downloaded and installed automatically during setup.
Run the following command in the directory you unpacked Downpour into:
sudo python setup.py install
If you do not have root access, you can install it in your user directory with:
python setup.py install --user
- Copy cfg/downpour.cfg to /etc/downpour.cfg and customize it, ensuring the directories listed in it are writable by the downpour user.
To start the downpour daemon, run the following command:
downpourd -c [config-file]
When launching as root, you can specify the user or group to run as with "--user" and "--group". Specifying a user or group on the command line is unnecessary if you have already specified one in downpour.cfg, since Downpour will automatically drop privileges after setup (useful if you want to use port 80 for the web interface.) User and group options are not available on Windows.
Run "downpourd --help" to view additional runtime options.
You can access the web interface at http://localhost:6280 (or whatever address/port you configured in downpour.cfg.) The default login is "admin" / "password". You can change the admin password in "My Account" once logged in, or setup additional users in the "Users" section.
To stop the daemon, run the following command:
It may take a few seconds to stop while it cleanly closes all bittorrent connections.