Whatbox Logo
Login for certain variables to be updated with your slot's information

Wiki > readarr

"Readarr is an ebook and audiobook collection manager for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new books from your favorite authors and will grab, sort, and rename them. Note that only one type of a given book is supported. If you want both an audiobook and ebook of a given book you will need multiple instances."

Readarr is currently in beta and may be unstable or broken.


The port number 18094 has automatically been generated by this page and will be used throughout this article, but can be changed to a port between 10000-32000 if needed.

  1. Connect to your slot with SSH

  2. Download the latest pre-release version of Readarr for Linux .NET Core x64

     wget https://github.com/Readarr/Readarr/archive/refs/tags/v2.0.0.4645.tar.gz
  3. Extract the archive

     tar zxvf Readarr-
  4. Temporarily start Readarr to generate configuration files

     ~/Readarr/Readarr & sleep 4 && pkill -f Readarr
  5. Edit the configuration file at ~/.config/Readarr/config.xml to use a unique port.

     nano ~/.config/Readarr/config.xml

    Change <Port>8787</Port> to <Port>18094</Port>

    Save the file by pressing Ctrl+S then exit nano with Ctrl+X

  6. Start Readarr

     screen -dmS Prowlarr ~/Readarr/Readarr

Immediately access http://server.whatbox.ca:18094/settings/general and set Authentication to Forms and add a username (like user) and password, then click "Save Changes" at the top of the page. This is required to protect your slot!

Automatic Restart (optional)

  1. Make a file to be used for the script. touch ~/Readarr_restart.cron

  2. Edit the file and enter the text below. nano -w ~/Readarr_restart.cron

     if pgrep -fx "/home/user/Readarr/Readarr" > /dev/null
         echo "Readarr is running."
         echo "Readarr is not running, starting Readarr"
  3. Save the file with Ctrl+S then exit nano with Ctrl+X

  4. Make the script executable. chmod +x ~/Readarr_restart.cron

  5. Open your crontab. EDITOR=nano crontab -e

  6. Enter the following text

     @reboot /home/user/Readarr_restart.cron >/dev/null 2>&1
     */5 * * * * /home/user/Readarr_restart.cron >/dev/null 2>&1
  7. Save the file with Ctrl+S then exit nano with Ctrl+X