CouchPotato, automatically download upcoming movies

CouchPotato downloads movies automatically in the best quality, once released on your favorite trackers.



“Honey, can you get this movie for tonight?”

“What? It is not even in the theater”

If you have time to time such conversation, CouchPotato is a must!

CouchPotato is with movie, what SickRage is with TV-Shows/Series.

Through a fancy and intuitive interface, it lets you search for movies and put them in your “To download” list. Once those movies will be available on torrent, it will automatically download them using your torrent client (Deluge, Transmission, uTorrent,..)


Their main page will start with some suggestions of movies based on your recent downloads and will also add some display new releases from IMDB or

Once you have found the movie you want to download, you can add it to your wanted list and select a quality (Some presets exist), like in HD (720p), Bluray, 3D, etc…


In the settings, you are able to select a list of trackers (Public or Private), set some rules to rename your movies once downloaded and even push some notifications to XMPP, Twitter, Emby, Slack, … or simply by email.

They have also developed a Firefox, Chrome and Safari extension to add an option to download a movie when you are visiting its page on IMDB, Apple Trailers and few others websites.


Interesting isn’t it!


So now let’s see how to install couchpotato on your own server, using Debian (like me) or Ubuntu (Should be similar)



1) Install Python and LXML

The first requirement is Python (>2.6) and they also recommend LXML for faster web scrapping.

In root or with sudo, run:

apt-get install python python-lxml


2) Make sure you have the latest pyOpenSSL
pip install --upgrade pyopenssl


3) Clone their latest repo

Assuming you already have git installed (apt-get install git, if not), run the following:

cd /var/www
git clone

This will download their latest version in the folder CouchPotatoServer. (Around 20mb)


4) Start the app
python CouchPotatoServer/

And you should now have access to your CouchPotato instance on http://yourIP:5050

But you probably wants the app to run at the startup of your machine.

If you are using Systemd:

cp CouchPotatoServer/init/couchpotato.service /etc/systemd/system/couchpotato.service

And update it with the path of the Python Script

nano /etc/systemd/system/couchpotato.service

and change




and finally, add it to the startup:

systemctl enable couchpotato

Now your couchpotato instance will start at every boot of your machine.


5) Configure CouchPotato

When accessing Couchpotato for the first time, you are able to configure your instance with:

  • Your login/password
  • Your torrent client settings (Deluge in my case, where I need to provide the server, user, login,…)
  • Your favorite trackers
  • and few others settings.

And it should all be working now ! Enjoy !


As usual in my case, I will also create a dedicated virtualhost (I don’t want to remember the port number) and enable SSL with Let’s Encrypt.

Here is my virtualhost for info:

<VirtualHost *:80>
        ServerName couch.mydomain.tld

        ProxyRequests Off
        <Proxy *>
        Order deny,allow
        Allow from all
        ProxyPass / http://localhost:5050/
        ProxyPassReverse / http://localhost:5050/

You will need the mod proxy html and http enabled, as shared in a rather old tutorial on how to redirect a sub-domain to a port.

apt-get install libapache2-mod-proxy-html
a2enmod proxy_http


Now it is time to be a couchpotato!! See ya


If you have questions on CouchPotato, I strongly recommend you to visit their github page.


Loves to discover web-based apps to install on his own server@home and write articles about it


Add a comment


Written on Fri, 18 Oct 2019 21:22:50 by Wekker76
Written on Fri, 18 Oct 2019 21:22:20 by Wekker76