Today, i faced this issue where the docker app not starting after an upgrade from the TrueNAS GUI. Here are my findings and how i resolve this.
I found out that there were cases documented where docker app wont start after restart or upgrade. This is caused by lock file due to improper shutdown, crash or container restart.
My first checking on the logs shows me this.
root@truenas[/home/admin]# docker ps |grep qbittorrent
40374294f805 ghcr.io/home-operations/qbittorrent:5.2.0 "/usr/bin/catatonit …" About a minute ago Restarting (0) 23 seconds ago ix-qbittorrent-qbittorrent-1root@truenas[/home/admin]#
root@truenas[/home/admin]# docker logs ix-qbittorrent-qbittorrent-1
(N) 2026-05-09T19:14:12 - qBittorrent v5.2.0 started. Process ID: 7
(N) 2026-05-09T19:14:12 - Using config directory: /config/qBittorrent
Another qBittorrent instance is already running.
QFile::at: Cannot set file position 0
(N) 2026-05-09T19:14:12 - qBittorrent termination initiated
(N) 2026-05-09T19:14:12 - qBittorrent is now ready to exit
QFile::at: Cannot set file position 0
On the config directory i can see a file called lockfile. So the next step is to remove it.
Common filenames usualy in cases like this:
- lockfile
- .lock
After removal, the docker app should be able to be restarted again.
root@truenas[...rustpool/apps/qbittorrent/qBittorrent]# ls -la
total 166
drwxrwx--- 6 apps root 19 May 3 23:51 .
drwxrwx--- 5 root root 6 Nov 25 17:01 ..
drwxrwx--- 2 apps root 55 May 3 23:57 BT_backup
drwxrwx--- 2 apps root 3 Apr 9 16:41 GeoDB
-rwxrwx--- 1 apps apps 196 Nov 10 2024 categories.json
srwx------ 1 apps root 0 Apr 29 23:57 ipc-socket
-rwxrwx--- 1 apps root 0 Apr 29 23:57 lockfile
drwxrwx--- 2 apps root 3 May 9 19:17 logs
-rwxrwx--- 1 apps apps 204 May 3 23:51 qBittorrent-data.conf
-rwxrwx--- 1 apps apps 198 Oct 19 2024 qBittorrent-data.conf.NHfgQe
-rwxrwx--- 1 apps apps 204 Oct 20 2024 qBittorrent-data.conf.XFGlin
-rwxrwx--- 1 apps apps 200 Oct 20 2024 qBittorrent-data.conf.cqdiMt
-rwxrwx--- 1 apps apps 195 Oct 30 2024 qBittorrent-data.conf.fzRwhK
-rwxrwx--- 1 apps apps 201 Oct 19 2024 qBittorrent-data.conf.lfVdGk
-rwxrwx--- 1 apps apps 204 Nov 25 2024 qBittorrent-data.conf.sFSjsy
-rwxrwx--- 1 apps apps 201 Oct 14 2024 qBittorrent-data.conf.xyOxra
-rwxrwx--- 1 apps apps 8653 Apr 29 23:56 qBittorrent.conf
drwxrwx--- 3 apps root 5 Apr 29 23:57 rss
-rwxrwx--- 1 apps apps 4 Aug 22 2024 watched_folders.json
root@truenas[...rustpool/apps/qbittorrent/qBittorrent]# rm -f lockfile