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

Wiki > Seerr

"Seerr is a free and open source software application for managing requests for your media library. It is a fork of Overseerr built to bring support for Jellyfin & Emby media servers"

Installation

  1. Connect to your slot through SSH

  2. Install pnpm and activate the latest version of Node 22

     curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=10.33.0 sh -
     
     source ~/.bashrc
     
     pnpm env add -g 22
     
     pnpm env use -g 22
    
  3. Update PNPM

     pnpm self-update
    
  4. Download the latest release of Seerr

    git clone --branch main https://github.com/seerr-team/seerr.git
    
  5. Enter Seerr's directory. If you're migrating from Overseerr see the Notes section below first.

    cd ~/seerr/
    
  6. Change the build settings. The CPU limit will allow Seerr to build correctly on our servers, especially when your slot is already running other programs.

    sed -i 's/1000,.*/1000, cpus: 8,/' next.config.js
    
  7. Install and build Seerr. This will take a long time; Seerr has many dependencies.

    CYPRESS_INSTALL_BINARY=0 pnpm install --frozen-lockfile; pnpm build
    
  8. Start Seerr

    cd ~/seerr && PORT=21697 screen -dmS seerr pnpm start
    

Seerr will take a few seconds to start. Access http://server.whatbox.ca:21697 and finish the setup procedure.

HTTPS

Add your Seerr port on your Domain Page.

Updating

  1. Connect to your slot through SSH

  2. Shut down Seerr

    screen -S seerr -X quit
    
  3. Ensure pnpm is updated

    pnpm self-update
    
  4. Enter Seerr's directory

    cd ~/seerr/
    
  5. Change the Git branch to the latest release and pull latest commits

    git reset --hard ; git fetch ; git checkout main; git pull
    
  6. Change the build settings. The CPU limit will allow Seerr to build correctly on our servers, especially when your slot is already running other programs.

    sed -i 's/1000,.*/1000, cpus: 8,/' next.config.js
    
  7. Install and build Seerr. This may take a long time; Seerr has many dependencies.

    CYPRESS_INSTALL_BINARY=0 pnpm install --frozen-lockfile; pnpm build
    
  8. Start Sseerr

    cd ~/seerr && PORT=21697 screen -dmS seerr pnpm start
    

Automatically Restart

  1. Make a file to be used for the script. touch ~/seerr_restart.cron
  2. Edit the file and enter the text below. nano -w ~/seerr_restart.cron
#!/bin/bash
if pgrep -fx "node dist/index.js" > /dev/null
then
    echo "seerr is running."
else 
    echo "seerr is not running, starting seerr"
    cd ~/seerr && PORT=21697 screen -dmS seerr /home/user/.local/share/pnpm/pnpm start
fi
exit
  1. Save the file with Ctrl+x and the "y" and Enter to accept overwriting.
  2. Make the script executable. chmod +x ~/seerr_restart.cron
  3. Open your crontab. EDITOR=nano crontab -e
  4. Enter the following text
@reboot /home/user/seerr_restart.cron >/dev/null 2>&1
*/5 * * * * /home/user/seerr_restart.cron >/dev/null 2>&1
  1. Save the crontab with Ctrl+x and the "y" and Enter to accept overwriting.

Notes

Use 127.0.0.1 as the address for connecting other apps if the app is running on the same server.

You may need to use IPv4 addresses for Sonarr. You can find your IPv4 address on your Slot Info page.

If Seerr fails to build, stop rclone processes on your slot and try again.

Migrating from Overseerr/Jellyseerr

After the git clone from Step 3, copy overseerr/config to the newly created seerr folder, then proceed to Step 4.

   cp -r ~/overseerr/config ~/seerr/

Make sure to remove or disable your automatic restart scripts for past app names. You can delete the Overseerr and Jellyseerr folders on your slot.