How to install CouchPotato on Ubuntu

CouchPotato is a free and opensource automatic NZB and torrent downloader, and in this tutorial, we shall see how to install and configure it on a Ubuntu PC.

Downloading movies and copying them over to your home server can get frustrating, especially if you are doing it daily! What if you have an option to download videos automatically, quickly, and above all with excellent quality. CouchPotato allows you to download movies easily once they are available and released automatically.


CouchPotato is a free, opensource automatic NZB and torrent downloader. It is a cross-platform software able to run on the most popular operating systems. Here is how it works, first you need to add what you want to watch to CouchPotato. CouchPotato has a built-in list named “Want to Watch”. Next, CouchPotato will perform all the remaining job for you; it will search for your movies in various multiple Torrent websites. Then when it reaches for the best potential match, it will start downloading the movie immediately through your favorable download application.

Welcome To CouchPotato

In this tutorial, we are going to walk you through the installation of CouchPotato on your Ubuntu machine. But before starting the installation process, kindly ensure that your system is updated using the following two commands:

sudo apt update
sudo apt upgrade

Now let’s begin installing the CouchPotato using the below-detailed steps.

Installing CouchPotato on Ubuntu


CouchPotato has some requirements that are needed to be installed on your machine before starting the CouchPotato installation. Open the Terminal and execute the following command to install Python.

sudo apt install python git

Pay attention to the Terminal and enter ‘Y’ when prompted.

Install Prerequisites For CouchPotato
Install Prerequisites For CouchPotato

Creating Required CouchPotato Directory

After successfully installing the CouchPotato prerequisites, we can now create the needed Directory to start installing the CouchPotato application.

Step 1. Execute the below command to create new CouchPotato Directory in the “opt” directory:

sudo mkdir /opt/couchpotato

Create CouchPotato Directory
Create CouchPotato Directory

Step 2. Move to the newly created CouchPotato directory to change your current location.

cd /opt/couchpotato

Move To the CouchPotato Directory
Move To the CouchPotato Directory

Get a CouchPotato Clone From Github

Now you can get a CoughPotato clone from the Github using the below command.

sudo git clone

Copy init CouchPotato File to init Directory
Copy init CouchPotato File to init Directory

Post-installation Configurations

At this point, we can configure the CouchPotato to start with every boot.

Step 1. Copy the CouchPotato file to the “init.d” Directory.

sudo cp CouchPotatoServer/init/ubuntu /etc/init.d/couchpotato

Copy init CouchPotato File to init Directory
Copy init CouchPotato File to init Directory

Step 2. Then let’s grant the CouchPotato file an execute permission as follows:

sudo chmod +x /etc/init.d/couchpotato

Grant Execute Permissions on Coppied File
Grant Execute Permissions on Copied File

Step 3. Next, let’s create a CouchPotato file using the command:

Create CouchPotato Configuration File
Create CouchPotato Configuration File

The previous command will create a new file just place the next few lines in the generated file:


As you can notice, you just need to replace the USERNAME with your username, as in the below screenshot. Next, save the configuration file and exit it.

Edit CouchPotato Configuration File
Edit CouchPotato Configuration File

Step 4. Execute the following command to update the boot sequence.

sudo update-rc.d couchpotato defaults

Update Boot Sequence
Update Boot Sequence

Step 5. Now you can start the CouchPotato service.

sudo service couchpotato start

Start CouchPotato Service
Start CouchPotato Service

Just in case, if you needed to stop the CouchPotato service, use:

sudo service couchpotato stop

Step 6. To check if the CouchPotato is up and running:

sudo service couchpotato status

Check CouchPotato Service Status
Check CouchPotato Service Status

Open The CouchPotato WebPage

After you have successfully configured the CouchPotato application, you can now open the CouchPotato webpage.

Step 1. Launch your favorite web browser.

Step 2. Go to the below URL to open the CouchPotato:


You should see the CouchPotato welcome page.

CouchPotato Home Page
CouchPotato Home Page

Step 2. Scroll down and configure the settings you need.

CouchPotato Prefrences
CouchPotato Preferences

Step 3. When you reach the end of the page, you can press the “I’m ready to start” button.

Ready To Start CouchPotato
Ready To Start CouchPotato

Step 4. You will get a login screen where you can use the username you have previously added in the CouchPotato configuration file.

Login to CouchPotato
Login to CouchPotato

Welcome to the CouchPotato, where you can search for the media you need to download and let CouchPotato download it for you.

Welcome To CouchPotato
Welcome To CouchPotato

Congratulations! You have just installed and configured the CouchPotato application successfully on your Ubuntu PC. We had used Ubuntu 20.04 LTS on our test PC. Still, the tutorial is expected to work on older Ubuntu versions as well as on the Ubuntu derivatives, including elementary OS, Linux Mint, Pop!_OS, and more.

Hend Adel
Hi! I'm Hend Adel, a freelancer technical geek with successful experience in Database, Linux and many other IT fields. I help to build solutions to suit business needs and creating streamlined processes. I love Linux and I'm here to share my skills via FOSS Linux! Thanks for reading my article.


  1. I love how clear and detailed the explanation is: I followed your instructions exactly but got the following when I tried to start the service:

    Job for couchpotato.service failed because the control process exited with error code.
    See “systemctl status couchpotato.service” and “journalctl -xe” for details.

    I don’t know if this matters but I substituted “Username” as this:

    CP_USER=humvee4me916 (my CP login name)
    CP_DATA=/home/ralph/couchpotato (my ubuntu name)

    Any pointers?



Please enter your comment!
Please enter your name here





The Ubuntu Cinnamon Remix brings together Linux Mint's Cinnamon desktop with the Ubuntu Core. While some users are welcoming the new flavor of Ubuntu with open arms, others are scratching their heads, wondering where it fits in.
The wait is finally over (almost) for all you Ubuntu fans out there. The latest version of Ubuntu, 20.10 codenamed "Groovy Gorilla," is currently available in the beta version. I have tested out the distro myself, and it is stable enough to take out for a spin.

10 Best PDF Editors for Linux

In this article, we will take a look at 10 of the best PDF editors and tools out there in 2019 that are available for Linux platforms. The editors are going to be judged on the basis of their functionalities, portability, ease of installation, price, and convenience.

6 Best CPU Stress Test and Performance Benchmark Linux Tools

Do you want to push your Linux system to its maximum limits? Or are you interested in evaluating your Linux PC in terms of performance? Either way, benchmark apps and stress test tools can give you a quantitative understanding of the performance of your Linux PC.

15 Tar command in Linux uses with examples

Tar is a famous utility that is basically used for collecting multiple files in a single archive. This file is often called a 'tarball'. Today, we are going to tell you about the different things you can do with tarballs using the tar command, with practical examples.

6 Best Linux Distros for Programmers and Developers

Linux distros have long been a favorite among programmers since the rise in popularity of the OS in the nineties. Programmers are technical by nature, and Linux distros appeal to that technical nature. Let's discuss why Linux is a great desktop OS for programmers and developers, and find out best distros suitable for them.