
Description
A BASH script to install various Usenet apps into a QNAP NAS.
sherpa is able to install several Usenet-related search and download apps but will only install ONE app at a time. If you elect to install an app that is already installed, the app will be fully reinstalled. This means the app configuration and settings are saved, the old app is uninstalled, a new version is installed, then the original settings are restored.
To install additional apps, run it again.
If the installer script is successful, your requested package and any required packages will be installed. Any existing installation of Entware will be used automatically. If Entware is not installed, a version appropriate to your NAS will be installed.
- Entware (standard)
- Git v2.18.0
- Python v2.7.16
- SABYenc v3.3.5
- Par2 or Par2cmdline-MT, except on ARMv5. This will use the single-thread par2 instead.
- Cryptography
- OpenSSL
- and one or more of the following apps installed from GitHub source (master-branch only):
- This one is installed via Entware and is a compiled binary:
Current status
- STABLE
Usage
- SSH / PuTTY into your NAS as the 'admin' user,
- Change to the Public share directory:
Code: Select all
cd /share/Public
- Download the installer script and make it executable:
Code: Select all
curl -skLO https://git.io/sherpa.sh && chmod +x sherpa.sh
- Then, to install (or reinstall) an app, run sherpa.sh with the name of your required app as an argument.
So, to install SABnzbd, use:Or:Code: Select all
./sherpa.sh SABnzbd
Code: Select all
./sherpa.sh SickChill ./sherpa.sh OWatcher3 ./sherpa.sh LazyLibrarian ./sherpa.sh Medusa ./sherpa.sh Headphones ./sherpa.sh NZBGet
- When you're done, delete the installer and debug log:
Code: Select all
rm sherpa.*
Known issues
- Sometimes, it seems existing installations of Entware can become "difficult" to work with. So, Entware can also be reinstalled, but this should only be used as a last resort. Using:
... will force sherpa to uninstall your existing Entware QPKG, then install a new one. Please note: Entware will be reverted back to default, and only the IPKGs required to support your installed sherpa apps will be installed.
Code: Select all
./sherpa.sh Entware
- sherpa is incompatible with Optware-NG as it's missing a few required packages.
Problems?
- This will happen from time-to-time as the environment changes. If it's not shown above in 'Known issues' then you may have found something new, so please add to this thread with the details of the problem you encountered. Diagnose where you can and provide a solution if you're able. The functions in this script are a community effort.
Sometimes the debug log will be required. This is always created. You can view this with:Or run the installer in debug-mode to see it realtime. e.g.:Code: Select all
cat sherpa.debug.log
There's now an option to check that all application dependencies have been satisfied. This will install any additional QPKGs or IPKGs to support any sherpa-installed applications present on your NAS:Code: Select all
./sherpa.sh SABnzbd --debug
Code: Select all
./sherpa.sh --check
Firmware compatibility
- QTS 4.4.x - OK
- QTS 4.3.x - OK
- QTS 4.2.x - OK
- QTS 4.1.x - Unknown
Notes
- The information contained therein was constructed from the efforts of many community members, both here and on the SABnzbd forum. Thank you to everyone who has contributed.
- Each of these packages continues the idea of 'self-update-on-launch' that was used in Clinton Hall's wrapper scripts. These scripts are my own version and require a few packages to be installed via Entware (this is what sherpa does). Updating an app is easy - just restart the app via its init script, or in the QTS App Center - "Stop" then "Start" will force an update.
- Medusa will appear as 'OMedusa' in your App Center to avoid conflict with the existing Medusa package available in the Qnapclub Store.
- Watcher3 will appear as 'OWatcher3' in your App Center to avoid conflict with the existing Watcher3 package available in the Qnapclub Store.
- The source for this project can be found on GitHub.