[BUG] qb 5.2.0 webui not started (KNOWN BUG NEED TO DELETE LOCKFILE)

[IITII]

UPSTREAM ISSUE: qbittorrent/qBittorrent#24164

Just delete /config/.config/qBittorrent/lockfile to get running again.

Is there an existing issue for this?

• I have searched the existing issues

Current Behavior

I am running qb 5.1.4 well.

But WebUI is not started when i changed image from linuxserver/qbittorrent:5.1.4 to linuxserver/qbittorrent:5.2.0

Expected Behavior

No response

Steps To Reproduce

1. a qb 5.1.4 instance, - ./qb_config:/config
2. changed image from linuxserver/qbittorrent:5.1.4 to linuxserver/qbittorrent:5.2.0
3. no WEBUI start...

Environment

- OS:
- How docker service was installed:

CPU architecture

x86-64

Docker creation

qb:
    # https://hub.docker.com/r/linuxserver/qbittorrent/tags
    # image: linuxserver/qbittorrent:4.5.2
    # image: linuxserver/qbittorrent:4.5.4
    image: linuxserver/qbittorrent:5.1.4
    # image: linuxserver/qbittorrent:5.2.0
    # image: linuxserver/qbittorrent:latest
    # image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qb
    hostname: qb
    restart: unless-stopped
    network_mode: host
    logging:
      driver: json-file
      options:
        max-size: 1m
    environment:
      - PUID=0   
      - PGID=0    
      - TZ=Asia/Shanghai
      - WEBUI_PORT=18081
    volumes:
      - /etc/hosts:/etc/hosts
      - ./qb_config:/config

Container logs

## start logs
### 5.1.4

❯ dc logs -f qb
qb  | [migrations] started
qb  | [migrations] no migrations found
qb  | ───────────────────────────────────────
qb  | 
qb  |       ██╗     ███████╗██╗ ██████╗
qb  |       ██║     ██╔════╝██║██╔═══██╗
qb  |       ██║     ███████╗██║██║   ██║
qb  |       ██║     ╚════██║██║██║   ██║
qb  |       ███████╗███████║██║╚██████╔╝
qb  |       ╚══════╝╚══════╝╚═╝ ╚═════╝
qb  | 
qb  |    Brought to you by linuxserver.io
qb  | ───────────────────────────────────────
qb  | 
qb  | To support LSIO projects visit:
qb  | https://www.linuxserver.io/donate/
qb  | 
qb  | ───────────────────────────────────────
qb  | GID/UID
qb  | ───────────────────────────────────────
qb  | 
qb  | User UID:    0
qb  | User GID:    0
qb  | ───────────────────────────────────────
qb  | Linuxserver.io version: 5.1.4-r3-ls453
qb  | Build-date: 2026-05-03T08:29:07+00:00
qb  | ───────────────────────────────────────
qb  |     
qb  | [custom-init] No custom files found, skipping...
qb  | WebUI 将在内部准备不久后启动。请稍等…
qb  | 
qb  | ******** 信息 ********
qb  | 要控制 qBittorrent，请访问下列地址的 WebUI：http://localhost:18081
qb  | Connection to localhost (::1) 18081 port [tcp/*] succeeded!
qb  | [ls.io-init] done.

### 5.2.0
* WebUI do not start in 10 mins.

❯ dc logs -f qb
qb  | [migrations] started
qb  | [migrations] no migrations found
qb  | usermod: user abc is currently used by process 1
qb  | ───────────────────────────────────────
qb  | 
qb  |       ██╗     ███████╗██╗ ██████╗
qb  |       ██║     ██╔════╝██║██╔═══██╗
qb  |       ██║     ███████╗██║██║   ██║
qb  |       ██║     ╚════██║██║██║   ██║
qb  |       ███████╗███████║██║╚██████╔╝
qb  |       ╚══════╝╚══════╝╚═╝ ╚═════╝
qb  | 
qb  |    Brought to you by linuxserver.io
qb  | ───────────────────────────────────────
qb  | 
qb  | To support LSIO projects visit:
qb  | https://www.linuxserver.io/donate/
qb  | 
qb  | ───────────────────────────────────────
qb  | GID/UID
qb  | ───────────────────────────────────────
qb  | 
qb  | User UID:    0
qb  | User GID:    0
qb  | ───────────────────────────────────────
qb  | Linuxserver.io version: 5.2.0_v2.0.12-ls454
qb  | Build-date: 2026-05-07T08:42:43+00:00
qb  | ───────────────────────────────────────
qb  |     
qb  | [custom-init] No custom files found, skipping...
^C
❯ dc up -d

[github-actions]

Thanks for opening your first issue here! Be sure to follow the relevant issue templates, or risk having this issue marked as invalid.

[j0nnymoe]

#430

[gokeefe]

Yup, deleting the lockfile fixed it for me.

qbittorrent/qBittorrent#24164

[j0nnymoe]

Closing the issue, please search existing issues people.

[eclae]

fix it for me too !

[j0nnymoe]

fix it for me too !

Read the post.

[eclae]

fix it for me too !

Read the post.

done
still fix it :)

[j0nnymoe]

Nothing for us to fix, it's an upstream bug.

[tigerblue77]

Closing the issue, please search existing issues people.
Read the post.
Nothing for us to fix, it's an upstream bug.

I understand that it can be frustrating when people don't read, but you could also:

• be nicer and less grumpy
• post a short message here or in the README explaining that linuxserver isn’t to blame and that the fix is rm /var/lib/docker/volumes/YOUR_QBITTORRENT_DOCKER_VOLUME_NAME/_data/qBittorrent/lockfile to save everyone time

@eclae was not spamming, just confirming that the fix works. OK his english is not perfect but hey, we're not all from UK/USA :)

Have a nice day :)