About this article
This article covers the installation of Overseerr within the QuickBox environment. If you are unsure about what Overseerr is, or if you are not sure it fits your needs, please refer to the Overseerr Quick Reference article for links and more about what Overseerr aims to achieve.
Install Overseerr from the Dashboard
- Login to your Dashboard at
https://SERVERIP(or)DOMAIN/login.php
- Navigate to your Apps Dashboard and click on the Application Management tab.
- Click on the Install button for Overseerr.
- You’re done! Once the install completes the page will reload with the relevant entries on your Dashboard.
Install Overseerr from CLI
- Login to your server via ssh.
- Once logged into your server type
sudo su -
orsudo -i
followed by hitting enter on your keyboard. This properly elevates your bash environment for runningqb
commands. - Once your bash is elevated you can now type
qb install overseerr USERNAME
(where USERNAME is your actual username within your QuickBox install).
For v3 installs:qb install overseerr -u USERNAME
Already have an Overseerr domain setup on your DNS? Great, run the install with the domain flag:qb install overseerr -u USERNAME -d OVERSEERR.DOMAIN.COM
- You’re done! On completion the relevant information for ports and access link will be posted.
After installing Overseerr
Overseerr currently does not have base url support for routing through the nginx reverse and therefore will default to access on it's assigned port. Should you have the ability to create your own subdomain for overseerr within your DNS, we have included a handy nginx template that you can edit to securely pass your overseerr to your assigned subdomain (ie; my-overseerr.somedomain.com)
Setup subdomain access for Overseerr
Once you have Overseerr installed and would like to access it over your controlled subdomain, you can edit the given nginx template to make this possible. The below explains the steps needed to get the job done!
With v3, ensure you have completed step 1 below. Then you can run:
qb install lecert -d some.overseerr.domain -o no-dash -o overseerr
This command will install your certificate and have the necessary nginx reverse created. If you installed Overseerr with the -d
(domain) flag, you will not need to utilize this command.
- Create your subdomain via an A Record at your DNS. The A record will utilize the same IP as your server. Name this record whatever you like (ie; my-overseerr.somedomain.com)
- With your subdomain created and ready, you will now want to generate an SSL certificate for the subdomain.
- If you have already made use of the
qb install lecert somedomain.com
command, you can run the below (copy/paste as root) :domain="PUT_YOUR_OVERSEERR_SUBDOMAIN_HERE" systemctl stop nginx mkdir -p /etc/nginx/ssl/${domain}/ cd /root/acme.sh ./acme.sh --issue -d ${domain} --standalone ./acme.sh --install-cert -d ${domain} \ --keylength ec-256 \ --cert-file /etc/nginx/ssl/${domain}/${domain}-ssl.pem \ --key-file /etc/nginx/ssl/${domain}/${domain}-privkey.pem \ --fullchain-file /etc/nginx/ssl/${domain}/${domain}-fullchain.pem \ --reloadcmd "systemctl restart nginx.service" \ --log /root/.quickbox/logs/${domain}.log
- If you have already made use of the
- With your SSL certificate now created and installed to
/etc/nginx/ssl/YOUR_SUBDOMAIN/
you will want to open and edit the nginx config template staged at/etc/nginx/sites-enabled/overseerr.conf.tmp
.- In the file everywhere you see
SUBDOMAIN
, change to the actual domain you have created. - Additionally, do make sure to uncomment (remove the
#
) from the fields forssl_certificate
andssl_certificate_key
. - Once edited and saved, rename the file to
overseerr.conf
and issue a restart to nginx withservice nginx restart
.
- In the file everywhere you see
- To have the access reflected on your QuickBox Pro Dashboard links you can edit the
url.override.php
located at/srv/quickbox/custom/
.- Open this file and scroll to the
/** ---OVERSEERR--- */
section and change the following:$overseerrURL = "http://" . $_SERVER['HTTP_HOST'] . ":5055";
- to the new subdomain you have assigned for access (as an example):
$overseerrURL = "https://YOUR_OVERSEERR_DOMAIN_HERE";
- Now save and close and issue a restart to php with
service php7.4-fpm restart
- Open this file and scroll to the
- If you have followed the above steps, you should now have a working and securely accessible over the subdomain Overseerr!