pyLoad is a download manager for 'Hoster' websites, video sites, and HTTP/FTP links. A list of supported sites can be found here


  1. Connect to your slot through SSH

  2. Create a Python 2.7 virtualenv with the instructions found here or use an existing one.

  3. With your virtualenv activated, install some missing Python modules

     pip install pycurl pillow
  4. Create ~/bin and add it to your shell's PATH if you haven't done so before. Download this compiled JavaScript binary to your bin directory.

     mkdir -p ~/bin && echo "PATH=\$HOME/bin:\$PATH" >> ~/.bashrc && source ~/.bashrc
     wget -O ~/bin/js && chmod +x ~/bin/js
  5. Download the latest pyLoad release

     wget -O
  6. Extract the archive

  7. ~/pyload/ will start the configuration setup wizard on first run. For most options, you can safely hit Enter to use the defaults. The following options should be changed/set accordingly:

     - Username [User]
     - Password
     - Password (again)
     - Enable remote access (Select 'n' if you only plan to use the web interface.)
     - Downloadfolder (Example: /home/user/files would download to your ~/files directory.)
     - Configure ssl? (Select 'y' if you want to use https for the web interface. Ignore the commands it tells you to run for now.)
     - Port 16837 (Use a random 5 digit port between 10000 and 65535. The port number `16837` has automatically been generated by this page and will be used throughout this article, but can be changed if needed [Default:8000].)
     - Server (If you plan to use https, you should select 'threaded')
  8. (Optional) If you plan to use SSL for your webinterface, you will need to set up your ssl cert and enable the Use HTTPS option.

     cd ~/.pyload
     openssl genrsa 1024 > ssl.key
     openssl req -new -key ssl.key -out ssl.csr
     openssl req -days 36500 -x509 -key ssl.key -in ssl.csr > ssl.crt
     sed -i 's/"Use HTTPS" = False/"Use HTTPS" = True/' ~/.pyload/pyload.conf
  9. With your virtualenv activated, you may now start the pyLoad daemon.

     ~/pyload/ --daemon
  10. (Optional) Clean up the installation archive

    rm ~/
  11. (Optional) Restart the service if the server restarts

    Your server may need to be rebooted from time to time for upgrades or maintenance, to restart this service automatically edit your crontab with crontab -e and add the following line:

    @reboot /home/user/virtualenv/bin/python2.7 /home/user/pyload/ --daemon


Web Interface

You may access your pyLoad web interface by going to where 16837 is the port you chose during configuration. If you chose to use SSL, you will need to use to access the web interface via HTTPS.

On first run, you will need to restart pyLoad from the Administrate link to load new/updated plugins.