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.


Please enter your comment!
Please enter your name here




Mastering the SQLite Database in Python

SQLite is a relational database management system based on the SQL language; it is a serverless, Zero-configuration database engine. It is one of the...

Basics of Working with the SQLite Database in Python

A database is one of the most useful and popular files for storing data; they can be used to store any kind of data, including text, numbers, images, binary data, files, etc. SQLite is a relational database management system based on the SQL language. It is a C library, and it provides an API to work with other programming languages, including Python. It does not require a separate server process to be run as needed in large database engines like MySQL and Postgresql.

5 Ways to Check the Linux Version

When most people talk of Linux, they are always referring to a Linux distribution. However, this is not the case. Linux itself is a kernel which acts as a bridge between user applications and the hardware. When we talk of a Linux distribution, we refer to an operating system developed from the Linux kernel. A distribution comes with a package manager, pre-installed applications, a Desktop Environment, and several more features.

Getting Started with Linux Operating System

The Linux operating system brings forth a vibrant mix of features and security, making it the best alternative to macOS or Windows operating systems. In this post, we will give you a master guide on Getting started with Linux systems - taking you from a complete beginner to a level where you can begin testing the various Linux distributions available with much ease.

How to Create a Comprehensive Mail Server on Ubuntu

Postal is a free and open-source mail server used to send and receive emails. It comes loaded with tons of excellent features and functionalities, making it extremely popular among large organizations as well as in enterprise settings.

The 10 Best Linux Performance Monitoring Tools

Do you want to monitor the performance of your Linux system? Are you looking for some powerful performance monitoring tools to help you out? If you agree, it's your day as we have put together a detailed list of the ten best Linux performance monitoring tools.


Buyers who wish to go for a machine that is based on Linux often show interest in Chromebooks due to the form factor and extended battery life capabilities. Although ChromeOS power these machines, users can still miss out on a more genuine Linux experience. For those who happen to agree, the new Lemur Pro by System76 might get some heads turning.
Linux is growing faster than ever. As per the latest report, there is a drop in the Windows 10 market share for the first time, and Linux's market share has improved to 2.87% this month. Most of the features in the list were rolled out in the Pop OS 20.04. Let's a detailed look into the new features, how to upgrade, and a ride through video.

Manjaro vs. Ubuntu – which is better for you?

If you are a person associated with Computer technology and spend most of the time in the open-source arena, you must have heard or worked with some of the popular Linux distributions we have in the market. Some of the names that you will never miss are; Ubuntu, Arch Linux, Debian, and Mint.

Beaker Browser: A P2P web browser you must try

I think we can all agree on the fact that the web browser is an integral part of our Linux systems, or any computer system, for that matter. We have had several fulfilling options for browsing the web, like Firefox, Brave, Vivaldi, Tor, etc. and they have worked pretty well, but also pretty much in the same way, except for Tor, which is much better for anonymity.

The 6 Best Download Managers for Fedora

It is a well-known fact that using download managers can help improve download speeds as compared to web browsers. Apart from the inbuilt download manager wget on Fedora, just as on any distribution that is based on GNU/Linux package, there are more options to explore.

5 Best Notepad++ Alternatives for Linux

Notepad++ has been the de facto standard for source code editors for nearly 16 years, almost since its creation in 2003.  For Windows users, that is.  For years, Linux users had no source code editor that compared to Notepad++ with all its bells and whistles, such as code folding, scripting, markup languages, syntax highlighting, auto-completion for programming (limited).