[QPKG] sherpa: a mini-package-manager (CLI)

[~] # /etc/init.d/entware.sh restart
-sh: /etc/init.d/entware.sh: No such file or directory

[~] # cd /etc/init.d/
[/etc/init.d] # ls
add_cloud_key.sh*			 porter.sh*
add_cloud_nat_rule.sh*			 power_button.sh*
addshare.sh*				 poweroff*
adjust_sync_speed.sh*			 pp_qcoolie.sh*
ads_register_dns.sh*			 push_notification_daemon.sh*
AdvancedNetDriver.sh.patch*		 pw_sleep.sh*
adv_net_drv.sh*				 qaccess.sh*
antivirus.sh*				 qanalytic_init.sh*
atalk.sh*				 qapi.sh*
avahi.sh*				 qat_setup.sh*
aws_key.sh*				 qboost.sh@
backup_conf.sh*				 qbutton.sh*
bcclient.sh*				 qcloud_blob_daemon.sh*
bluetooth.sh*				 qcloud_init.sh*
bonjour.sh@				 QcloudSSLCertificate.sh@
boot_done.sh*				 qdff_mount.sh*
cacd.sh*				 qlsmd.sh*
callhome_upload_disk_phy_event.sh*	 qm2_nic.sh*
callhome_upload_disk_smart.sh*		 QMediaService.sh*
callhome_upload_fan.sh*			 qmigrate.sh*
callhome_upload_network_nic.sh*		 qpkg_res.sh@
callhome_upload_network_stack.sh*	 qpkg.sh@
callhome_upload_psu.sh*			 qplayd.sh*
cdrom.sh*				 qraid1.sh*
check_bootcmd.sh*			 qsnapman.sh*
check_ddns_external_ip.sh*		 qstorman.sh*
check_fw_update_cs.sh*			 qsyncsrv_install.sh*
check_lan_port.sh*			 qsyncsrv.sh@
_check_nss2*				 qtag.sh*
check_nss2*				 Qthttpd.sh*
check_service_noshare_run*		 qts_notice.sh*
chkcfgpart.sh*				 qulog.sh@
cloudinstall_finish.sh*			 qunetswitch.sh*
cloudinstall_init_daemon.sh*		 radius.sh*
cloudinstall_init.sh*			 radvd.sh*
cloudinstall_report_complete_daemon.sh*  rcK*
cloudinstall_report_offline.sh*		 rcS*
convert2_ext4.sh*			 rcS_normal*
create_udev_rule.sh*			 rcv_port.sh*
crond.sh*				 reboot*
cs_daemon.sh*				 recoverd.sh*
cs_fw_verify.sh*			 recycled.sh*
cs_verify_tool*				 refresh_internet_status.sh*
da_iotest.sh*				 refresh_nvr_crontab.sh*
dbus.sh*				 report_cloud_platform.sh*
ddns_update_for_cgi.sh*			 reset_all.sh*
ddns_update.sh*				 reset_sata.sh*
disk_data_collection.sh*		 reset_tl_rxx00pes.sh*
dump_all_trct_log.sh*			 reverse_proxy.sh*
enc_migrate.sh*				 rfsd.sh*
Entware.sh@				 root_cert

Weird, no such file, although Entware.sh@ is listed in there, what is the “@” at the end of the name?!

Hi OneCD.

I tried running sherpa upgrade alltoday, but alas, my sab installation is not working. Admittedly, it’s been a LONG time since I’ve done any sherpa operations, and recently updated the OS on the QNAP.

Since sab is pretty much the main application that I use the NAS for (besides file storage), hoping you might be willing to help me sort this out.

20:35:10-admin@doraemon:VIDEO(1005)$ sherpa status
sherpa v260409-stable
done: actions complete.

QPKG name:             Status & Last action (result):
duf                  - enabled, active, start (OK)
Entware              - enabled, active, unsupported
HideThatBanner       - enabled, active, start (OK)
OTransmission        - enabled, active, start (OK)
Par2turbo            - enabled, active, unsupported
SABnzbd              - enabled, inactive, start (failed)
sherpa               - enabled, active, start (OK)
SortMyQPKGs          - disabled, inactive, not-found
Unrar                - enabled, active, unsupported

• Report information:
‘disabled’- QPKG won’t be started at bootup. Enable it first, then start it.
‘(failed)’- previous action failed.
‘inactive’- application process is dead or not-started. Try starting it.
‘enabled’- QPKG will be started at bootup.
‘(OK)’- previous action was successful.
‘active’- application is alive (and responsive if a daemon).
‘dynamic’       - application version is the latest available.
‘not-found’- action tracking files were not found.
‘unsupported’- action tracking is unsupported by this QPKG.

To disable this report information panel:
# sherpa report-info off

20:35:45-admin@doraemon:VIDEO(1006)$ sherpa start sab
sherpa v260409-stable
done: actions complete.

• Package actions started @ 8:37:41 PM, ended @ 8:42:54 PM, elapsed = 5m:13s

• These package actions completed OK:
reactivate Par2turbo QPKG in 1 second
reactivate Unrar QPKG in 1 second
reactivate Entware QPKG in 1 second

• These package actions failed (and why):
install 4 auxiliary IPKs in 4 seconds (255)
activate SABnzbd QPKG in 5m:03s (file /opt/bin/git not found (exceeded timeout: 300 seconds))

Any recommended next steps?

I tried updating today as well and I have the same error. Did an update about 2 weeks ago which still worked.
sherpa status

sherpa v260409-stable
done: actions complete.

QPKG name: Status & Last action (result):
Entware - enabled, active, unsupported
Par2turbo - enabled, active, unsupported
SABnzbd - enabled, inactive, start (in-progress)
sherpa - enabled, active, start (OK)
Unrar - enabled, active, unsupported

Reinstalling SAB didn’t work either and activating also doesn’t and neither does ‘sherpa fix‘.

My bad. :frowning:

The command should have been:

/etc/init.d/Entware.sh restart

The trailing @ means the file you see is actually a symlink to another file.

Can you please generate an ‘about’ report and post it back here?

sudo sherpa a

Can you please start SABnzbd manually in debug mode?

/etc/init.d/sabnzbd.sh start debug

… then post what you see back here?

[~] # /etc/init.d/Entware.sh restart
Disable Entware/opkg
Enable Entware/opkg
mv: can't remove '/opt/wsd': Is a directory

still no luck, after sherpa s and sherpa fix it’s still inactive

[~] # sherpa s
sherpa v260409-stable
note: the Entware QPKG will be auto-reinstalled (Entware packages were last updated in early-April 2026).
done: actions complete.

QPKG name:      Status:              Last action (result):  QPKG version:  Appl>
  Entware       - enabled, inactive    unsupported            1.03a          1.>
  Par2turbo     - enabled, active      unsupported            1.2.0          1.>
  sherpa        - enabled, active      start (OK)             251212         25>
  Transmission  - enabled, active      start (OK)             260406         4.>

Can you please reinstall Entware?

sherpa reinstall ew
[~] # sherpa reinstall ew
sherpa v260412-stable
note: the Entware QPKG will be auto-reinstalled (Entware packages were last updated in early-April 2026).
done: actions complete.

• Package actions started @ 2:47:23 AM, ended @ 2:47:44 AM, elapsed = 21 seconds

• These package actions completed OK:
    deactivate Transmission QPKG in 2 seconds
    deactivate Entware QPKG in 1 second
    activate Transmission QPKG in 4 seconds

• These package actions were skipped (and why):
    download Entware QPKG in 1 second (already downloaded)
    "sign" Entware QPKG in 1 second (already signed)
    install Entware QPKG in 1 second (already installed, please use 'reinstall' instead)

• This package action failed (and why):
    uninstall Entware QPKG in 1 second ('.uninstall.sh' not found)

[~] # sherpa s
sherpa v260412-stable
done: actions complete.

QPKG name:      Status:              Last action (result):  QPKG version:  Appl. version:  Location:
  Entware       - enabled, inactive    unsupported            1.03a          1.03a           /share/CACHE>
  Par2turbo     - enabled, active      unsupported            1.2.0          1.2.0           /share/CACHE>
  sherpa        - enabled, active      start (OK)             251212         251212          /share/CACHE>
  Transmission  - enabled, active      start (OK)             260406         4.0.6           /share/CACHE>

• Report information:
   'inactive'     - application process is dead or not-started. Try starting it.
   'enabled'      - QPKG will be started at bootup.
   '(OK)'         - previous action was successful.
   'active'       - application is alive (and responsive if a daemon).
   'unsupported'  - action tracking is unsupported by this QPKG.

   To disable this report information panel:
      # sherpa report-info off

the same, Entware enabled and inactive :confused:

Damn, looks like your Entware installation is quite-broken. It couldn’t be uninstalled in the usual manner. :frowning:

Let’s remove it manually:

rm -r $(getcfg Entware Install_Path -f /etc/config/qpkg.conf);
rmcfg Entware -f /etc/config/qpkg.conf

… then install it again:

sherpa fix

Thanks, OneCD. Here’s the output:

12:34:37-admin@doraemon:VIDEO(1005)$ sudo sherpa a
sherpa v260412-stable
dbug: (II) --------------------------------------------------------------------------------------------------------
dbug: (**)  HARDWARE:                NAS model: TS-853A
dbug: (**)  HARDWARE:                      CPU: Intel(R) Celeron(R) CPU N3160 @ 1.60GHz
dbug: (**)  HARDWARE:                CPU cores: 4
dbug: (**)  HARDWARE:         CPU architecture: x86_64 (64b)
dbug: (**)  HARDWARE: basic CPU SHA1 benchmark: unable to measure, GNU ‘dd’ is unavailable
dbug: (**)  HARDWARE:                      RAM: 15.54GiB
dbug: (**)    KERNEL:                     name: GNU/Linux
dbug: (**)    KERNEL:                  version: 5.10.60-qnap
dbug: (**)    KERNEL:                page size: 4096B
dbug: (**)  FIRMWARE:                       OS: QTS
dbug: (**)  FIRMWARE:                  version: 5.2.9.3410
dbug: (**)  FIRMWARE:               build date: 20260214 (Sat 14 Feb 2026)
dbug: (**)  FIRMWARE:                 platform: X86_BRASWELL
dbug: (**)        OS:                    state: online
dbug: (**)        OS:                   uptime: 187h:54m:48s
dbug: (**)        OS:            load averages: 1m:0.41, 5m:0.45, 15m:0.49
dbug: (**)   STORAGE:   default volume mounted: /share/CACHEDEV1_DATA
dbug: (**)   STORAGE:    basic write benchmark: unable to measure, GNU ‘dd’ is unavailable
dbug: (**)   STORAGE:                     /opt: /share/CACHEDEV1_DATA/.qpkg/Entware
dbug: (**) USERSPACE:                     libc: (GNU libc) 2.21
dbug: (**) USERSPACE:           libc copyright: Copyright (C) 2015 Free Software Foundation, Inc.
dbug: (**) USERSPACE:                    $EUID: 0
dbug: (NA) USERSPACE:                $SUDO_UID: N/A
dbug: (**) USERSPACE:          BusyBox version: BusyBox v1.24.1 (2026-02-14 02:11:16 CST) multi-call binary.
dbug: (**) USERSPACE:        BusyBox copyright: BusyBox is copyrighted by many authors between 1998-2015.
dbug: (**) USERSPACE:   BusyBox function count: 166
dbug: (**)    SCRIPT:             QPKG version: 251212 (Fri 12 Dec 2025)
dbug: (**)    SCRIPT:          manager version: 260412-stable
dbug: (**)    SCRIPT:            manager epoch: 1775947762 (Sun 12 Apr 2026 5:49:22 AM ICT)
dbug: (**)    SCRIPT:            objects epoch: 1775947758 (Sun 12 Apr 2026 5:49:18 AM ICT)
dbug: (**)    SCRIPT:           packages epoch: 1775695750 (Thu 9 Apr 2026 7:49:10 AM ICT)
dbug: (**)      QPKG:          package release: v260409 (Thu 9 Apr 2026)
dbug: (NA)      QPKG:         allow unofficial: N/A
dbug: (**)      QPKG:           require signed: no
dbug: (**)      QPKG:             architecture: i64 (Intel x86-64)
dbug: (**)      QPKG:   date Entware installed: 2026-04-11 (Sat 11 Apr 2026)
dbug: (**)      QPKG:             Entware type: std
dbug: (**)      QPKG:              SortMyQPKGs: installed
dbug: (NA)      QPKG:         IncreaseTimeouts: N/A
dbug: (II) 

OK, a few things to fix. :nerd_face:

You won’t need SortMyQPKGs anymore, so let’s uninstall it. Also, the OTransmission QPKG was replaced with Transmission.

But, let’s start by fixing Entware:

sudo sherpa fix

… then please remove SortMyQPKGs and migrate from OTransmission to Transmission:

sudo sherpa rm sort otrans backup otrans rebuild trans

If SABnzbd wasn’t started automatically as part of the above, please start it manually:

sudo sherpa start sab

WOW! Thanks, OneCD! 2 commands and everything is fixed, and I even got an updated Transmission too!

13:24:27-admin@doraemon:VIDEO(1008)$ sudo sherpa fix
sherpa v260412-stable
done: actions complete.

• Package actions started @ 1:24:47 PM, ended @ 1:27:55 PM, elapsed = 3m:08s

• These package actions completed OK:
install 14 auxiliary IPKs in 46 seconds
install auxiliary PIP in 21 seconds
reactivate OTransmission QPKG in 5 seconds
reactivate SABnzbd QPKG in 1m:52s

• These package actions were skipped (and why):
“sign” duf QPKG in 1 second (already signed)
“sign” Entware QPKG in 1 second (already signed)
“sign” HideThatBanner QPKG in 1 second (already signed)
“sign” Par2turbo QPKG in 1 second (already signed)
“sign” sherpa QPKG in 1 second (already signed)
“sign” SortMyQPKGs QPKG in 1 second (already signed)
“sign” Unrar QPKG in 1 second (already signed)
“sign” OTransmission QPKG in 1 second (already signed)
“sign” SABnzbd QPKG in 1 second (already signed)

13:27:56-admin@doraemon:VIDEO(1009)$ sudo sherpa rm sort otrans backup otrans rebuild trans
sherpa v260412-stable
done: actions complete.

• Package actions started @ 1:28:23 PM, ended @ 1:29:32 PM, elapsed = 1m:09s

• These package actions completed OK:
meta-rebuild Transmission QPKG in 1 second
download Transmission QPKG in 1 second
deactivate OTransmission QPKG in 2 seconds
backup OTransmission QPKG in 11 seconds
uninstall OTransmission QPKG in 6 seconds
deactivate SortMyQPKGs QPKG in 1 second
uninstall SortMyQPKGs QPKG in 7 seconds
reactivate Entware QPKG in 2 seconds
install 2 auxiliary IPKs in 7 seconds
“sign” Transmission QPKG in 1 second
install Transmission QPKG in 11 seconds (v260406)
restore Transmission QPKG in 3 seconds

I’m going to have to remember that fix command!

Awesome! :tada:

Yes, fix is a good first step to take, as it’s written to fix several issues known to occur. It’s not perfect, but I do add extra functions to it from time-to-time.

[~] # sherpa s
sherpa v260412-stable
done: actions complete.

QPKG name:      Status:            Last action (result):  QPKG version:  Appl. version:  Location:
  Entware       - enabled, active    unsupported            1.03a          1.03a           /share/CACHEDE>
  Par2turbo     - enabled, active    unsupported            1.2.0          1.2.0           /share/CACHEDE>
  sherpa        - enabled, active    start (OK)             251212         251212          /share/CACHEDE>
  Transmission  - enabled, active    start (OK)             260406         4.0.6           /share/CACHEDE>

• Report information:
   'enabled'      - QPKG will be started at bootup.
   '(OK)'         - previous action was successful.
   'active'       - application is alive (and responsive if a daemon).
   'unsupported'  - action tracking is unsupported by this QPKG.

   To disable this report information panel:
      # sherpa report-info off

Manually remove the Entware did the trick, thank you so much!! :+1:

Great! :tada:

Hi OneCD,
Here’s the output of the start command:

sudo /etc/init.d/sabnzbd.sh start debug
Password:
source: sabnzbd.sh, action: start, time: Sun 12 Apr 2026 6:47:14 PM CEST, load: 1.16
package: 260409, service: 260409, library: 260406
QPKG enabled: true
application auto-update: false
active git branch:
daemon PID: none
> watch for /opt/bin/git to appear in filesystem (no-more than 300 seconds): 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, ! file /opt/bin/git not found (exceeded timeout: 300 seconds)
> = source: sabnzbd.sh, action: start, time: Sun 12 Apr 2026 6:52:15 PM CEST, result: FAILED, elapsed: 0h:05m:01s, load: 0.80

Hi @OneCD,

I found it (unless you have created a fix in the meantime…), but temporary unblocking a certain state/country from my firewall deny list resolved the issue. It’s now running again.

Nice! :tada:

I think the Entware site has had some intermittent issues over the last couple of days. I found several times the download of Entware packages would hang, which can cause a broken Entware installation.

And I did make a couple of changes to the fix routines yesterday. :wink:

On my TS-451+ I was also getting the same error as dpantera and btjukker when trying to upgrade sortmyqpkgs, entware, and sabnzbd, but I fixed it.

The error was

activate SABnzbd QPKG in 5m:03s (file /opt/bin/git not found (exceeded timeout: 300 seconds))

(Because I’m still on QTS-4.5.4, I don’t need sudo when logged in as admin using ssh below)

What I did was

opkg install git
sherpa start sab

but it now told me git-clone failed. So I read your wiki and got my software running again with

sherpa fix

Maybe the entware upgrade left me without some needed packages, and ‘fix’ installed them. Thanks for everything :slight_smile: