WebUI with password failed to start in docker

[janusn]

Check the bug
Before filling this bug report, please search if a similar issue already exists.
In this case, just add a comment on this existing issue.

Describe the bug
A clear and concise description of what the bug is.

Following the documentation How to protect your Dockerized server (or Web server) with a login/password ? resulted in error.

To Reproduce
Steps to reproduce the behavior:

1. Start a docker glances with the following compose.yaml

---
services:
  glances:
    image: nicolargo/glances:latest
    container_name: glances
    privileged: true
    pid: host
    network_mode: host
    environment:
    - "TZ=Europe/London"
    - "GLANCES_OPT=-C /config/glances.conf -w"
    volumes:
    - /var/run/docker.sock:/var/run/docker.sock:ro
    - ./etc/glances.conf:/etc/glances/glances.conf:ro
    - ./config:/config/:ro
    - /etc/os-release:/etc/os-release:ro
    restart: unless-stopped

2. Execute the following command in bash

# docker exec -it glances sh
/app # glances -w --username
Enter new username: ha
Enter new password: 
Confirm new password: 
Do you want to save the password in /root/.config/glances/ha.pwd ? [Yes/No]: yes

  _____ _
 / ____| |
| |  __| | __ _ _ __   ___ ___  ___
| | |_ | |/ _` | '_ \ / __/ _ \/ __|
| |__| | | (_| | | | | (_|  __/\__
 \_____|_|\__,_|_| |_|\___\___||___/ 4.5.4
        
WARNING: Glances web server is running without Host header validation.
         DNS rebinding attacks may allow untrusted pages to read the REST API.
         Set webui_allowed_hosts in glances.conf [outputs] to restrict access:
           webui_allowed_hosts=localhost,127.0.0.1,<your-hostname>
         See https://glances.readthedocs.io/en/latest/api/restful.html#security

Glances Web User Interface started on http://0.0.0.0:61208/
Glances RESTful API Server started on http://0.0.0.0:61208/api/4
INFO:     Started server process [258775]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
ERROR:    [Errno 98] error while attempting to bind on address ('0.0.0.0', 61208): [errno 98] address in use
INFO:     Waiting for application shutdown.
INFO:     Application shutdown complete.
/app # exit
# docker cp glances:/root/.config/glances/ha.pwd ./secrets/ha_password.txt
Successfully copied 2.05kB to /mnt/tank/docker/glances/secrets/ha_password.txt

3. update the compose.yaml to the following content:

---
services:
  glances:
    image: nicolargo/glances:latest
    container_name: glances
    privileged: true
    deploy:
      resources:
        limits:
          memory: 512M
    pid: host
    network_mode: host
    environment:
    - "TZ=Europe/London"
    - "GLANCES_OPT=-C /config/glances.conf -w --password"
    volumes:
    - /var/run/docker.sock:/var/run/docker.sock:ro
    - ./etc/glances.conf:/etc/glances/glances.conf:ro
    - ./config:/config/:ro
    - /etc/os-release:/etc/os-release:ro
    secrets:
    - source: glances_ha_password
      target: /root/.config/glances/ha.pwd
    restart: unless-stopped

secrets:
  glances_ha_password:
    file: ./secrets/ha_password.txt

4. Restart the docker glances.

Expected behavior
A clear and concise description of what you expected to happen.
The glances runs in webui mode with authentication enabled.

Screenshots
If applicable, add screenshots to help explain your problem.

Environement (please complete the following information)

• Operating System (lsb_release -a or OS name/version):

$ lsb_release -a
No LSB modules are available.
Distributor ID:	Debian
Description:	Debian GNU/Linux 12 (bookworm)
Release:	12
Codename:	bookworm

• Glances & psutil versions:

# glances -V
Glances version:	4.5.4
Glances API version:	4
PsUtil version:		7.2.2
Log file:		/tmp/glances-root.log

• How do you install Glances (Pypi package, script, package manager, source): docker
• Glances test: with environment variable "GLANCES_OPT=-C /config/glances.conf -w"

# glances --issue
===============================================================================
Glances 4.5.4 (/app/glances/__init__.py)
Python 3.12.13 (/venv/bin/python3)
PsUtil 7.2.2 (/venv/lib/python3.12/site-packages/psutil/__init__.py)
===============================================================================
alert         [OK]    0.00005s 
[]
amps          [OK]    0.00047s key=name 
[{'count': 0,
  'countmax': None,
  'countmin': 1.0,
  'key': 'name',
  'name': 'Dropbox',
  'refresh': 3.0,
  'regex': True,
  'result': None,
  'timer': 2.492063522338867}, ...]
cloud         [NA]
connections   [NA]
containers    [OK]    0.10699s key=name 
[{'command': '/init',
  'cpu_percent': 82.98372007366483,
  'created': '2026-04-09T21:50:18.71632831Z',
  'engine': 'docker',
  'id': '7b5dc0798c48d1ad27ecd27cdc0eab08eaba2486c869d16233027a4166ab29fc',
  'image': ('ghcr.io/blakeblackshear/frigate:stable',),
  'io_rx': None,
  'io_wx': None,
  'key': 'name',
  'memory_inactive_file': 6234759168,
  'memory_limit': 8589934592,
  'memory_percent': None,
  'memory_usage': 8522362880,
  'name': 'frigate',
  'network_rx': None,
  'network_tx': None,
  'ports': '5000->5000/tcp,8554->8554/tcp,8555->8555/tcp,8555->8555/udp,8971->8971/tcp',
  'status': 'healthy',
  'uptime': 'an hour'}, ...]
core          [OK]    0.00105s 
{'log': 16, 'phys': 12}
cpu           [OK]    0.00065s 
{'cpucore': 16,
 'ctx_switches': 0,
 'ctx_switches_gauge': 270951995,
 'ctx_switches_rate_per_sec': 0,
 'guest': 0.0,
 'idle': 89.5,
 'interrupts': 0,
 'interrupts_gauge': 87926632,
 'interrupts_rate_per_sec': 0,
 'iowait': 0.2,
 'irq': 0.0,
 'nice': 0.2,
 'soft_interrupts': 0,
 'soft_interrupts_gauge': 83748514,
 'soft_interrupts_rate_per_sec': 0,
 'steal': 0.0,
 'syscalls': 0,
 'syscalls_gauge': 0,
 'syscalls_rate_per_sec': 0,
 'system': 2.6,
 'time_since_update': 2.1545729637145996,
 'total': 10.3,
 'user': 7.0}
diskio        [OK]    0.00129s key=disk_name 
[{'disk_name': 'nvme0n1',
  'key': 'disk_name',
  'read_bytes': 0,
  'read_bytes_gauge': 2452510720,
  'read_bytes_rate_per_sec': 0,
  'read_count': 0,
  'read_count_gauge': 101277,
  'read_count_rate_per_sec': 0,
  'read_latency': 0,
  'read_time': 0,
  'read_time_gauge': 9912,
  'read_time_rate_per_sec': 0,
  'time_since_update': 2.183035373687744,
  'write_bytes': 0,
  'write_bytes_gauge': 1274277888,
  'write_bytes_rate_per_sec': 0,
  'write_count': 0,
  'write_count_gauge': 83278,
  'write_count_rate_per_sec': 0,
  'write_latency': 0,
  'write_time': 0,
  'write_time_gauge': 16301,
  'write_time_rate_per_sec': 0}, ...]
folders       [OK]    0.00004s 
[]
fs            [OK]    0.03114s key=mnt_point 
[{'device_name': 'tank/docker',
  'free': 1537268121600,
  'fs_type': 'zfs',
  'key': 'mnt_point',
  'mnt_point': '/config',
  'options': 'ro,noatime,xattr,posixacl,casesensitive',
  'percent': 1.0,
  'size': 1552240607232,
  'used': 14972485632}, ...]
gpu           [NA]
help          [OK]    0.00002s 
None
ip            [OK]    0.00652s 
{'address': '***', 'mask': '***', 'mask_cidr': '***'}
irq           [NA]
load          [OK]    0.00010s 
{'cpucore': 16, 'min1': 1.8447265625, 'min15': 1.90966796875, 'min5': 2.04296875}
mem           [OK]    0.00107s 
{'active': 5948141568,
 'available': 25472697256,
 'buffers': 57344,
 'cached': 14831512232,
 'free': 12544700416,
 'inactive': 6273007616,
 'percent': 23.3,
 'percent_max': 23.3,
 'percent_mean': 23.2,
 'percent_min': 23.1,
 'shared': 386924544,
 'total': 33189978112,
 'used': 7717280856}
memswap       [OK]    0.00041s 
{'free': 0, 'percent': 0.0, 'sin': 0, 'sout': 0, 'time_since_update': 2.461714267730713, 'total': 0, 'used': 0}
mpp           [OK]    0.00007s 
[]
network       [OK]    0.00583s key=interface_name 
[{'alias': None,
  'bytes_all': 5380316,
  'bytes_all_gauge': 31825383313,
  'bytes_all_rate_per_sec': 2481927.0,
  'bytes_recv': 4801717,
  'bytes_recv_gauge': 12233946849,
  'bytes_recv_rate_per_sec': 2215020.0,
  'bytes_sent': 578599,
  'bytes_sent_gauge': 19591436464,
  'bytes_sent_rate_per_sec': 266906.0,
  'interface_name': 'enp86s0',
  'key': 'interface_name',
  'speed': 1048576000,
  'time_since_update': 2.167797803878784}, ...]
now           [OK]    0.00009s 
{'custom': '2026-05-07 18:05:47 BST', 'iso': '2026-05-07T18:05:47+01:00'}
npu           [OK]    0.00009s 
[]
percpu        [OK]    0.00120s key=cpu_number 
[{'cpu_number': 0,
  'dpc': None,
  'guest': 0.0,
  'guest_nice': 0.0,
  'idle': 88.6,
  'interrupt': None,
  'iowait': 0.0,
  'irq': 0.0,
  'key': 'cpu_number',
  'nice': 0.0,
  'softirq': 0.5,
  'steal': 0.0,
  'system': 2.3,
  'total': 11.4,
  'user': 8.7}, ...]
ports         [OK]    0.00001s key=indice 
[{'description': 'DefaultGateway',
  'host': '10.27.0.1',
  'indice': 'port_0',
  'key': 'indice',
  'port': 0,
  'refresh': 30,
  'rtt_warning': None,
  'status': 0.002062,
  'timeout': 3}, ...]
processcount  [OK]    0.13864s 
{'pid_max': 0, 'running': 1, 'sleeping': 500, 'thread': 2763, 'total': 1072}
processlist   [OK]    0.00093s 
[]
programlist   [OK]    0.00644s 
[]
psutilversion [OK]    0.00004s 
'7.2.2'
quicklook     [OK]    0.00055s 
{'cpu': 10.3,
 'cpu_hz': 4000000000.0,
 'cpu_hz_current': 2739916187.5000005,
 'cpu_log_core': 16,
 'cpu_name': '13th Gen Intel(R) Core(TM) i5-1340P',
 'cpu_phys_core': 12,
 'load': 11.9,
 'mem': 23.2,
 'percpu': [{...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...},
            {...}],
 'swap': 0.0}
raid          [NA]
sensors       [OK]    0.02119s key=label 
[{'critical': 93,
  'key': 'label',
  'label': 'Composite',
  'type': 'temperature_core',
  'unit': 'C',
  'value': 34,
  'warning': 89}, ...]
smart         [OK]    0.00004s 
{}
system        [OK]    0.00001s 
{'hostname': 'nuc13-glances',
 'hr_name': 'Debian GNU/Linux 12 64bit / Linux 6.12.33-production+truenas',
 'linux_distro': 'Debian GNU/Linux 12',
 'os_name': 'Linux',
 'os_version': '6.12.33-production+truenas',
 'platform': '64bit'}
uptime        [OK]    0.00017s 
{'seconds': 6785}
version       [OK]    0.00002s 
'4.5.4'
vms           [OK]    0.00007s 
[]
wifi          [NA]
===============================================================================
Total time to update all stats: 0.33123s
===============================================================================
/app # janus@nuc13:/mnt/tank/docker/glances$ sudo docker exec -it glances sh
/app # glances --issue
===============================================================================
Glances 4.5.4 (/app/glances/__init__.py)
Python 3.12.13 (/venv/bin/python3)
PsUtil 7.2.2 (/venv/lib/python3.12/site-packages/psutil/__init__.py)
===============================================================================
alert         [OK]    0.00004s 
[]
amps          [OK]    0.00036s key=name 
[{'count': 0,
  'countmax': None,
  'countmin': 1.0,
  'key': 'name',
  'name': 'Dropbox',
  'refresh': 3.0,
  'regex': True,
  'result': None,
  'timer': 2.5318081378936768}, ...]
cloud         [NA]
connections   [NA]
containers    [OK]    0.07830s key=name 
[{'command': '/init',
  'cpu_percent': 222.32688544891639,
  'created': '2026-04-09T21:50:18.71632831Z',
  'engine': 'docker',
  'id': '7b5dc0798c48d1ad27ecd27cdc0eab08eaba2486c869d16233027a4166ab29fc',
  'image': ('ghcr.io/blakeblackshear/frigate:stable',),
  'io_rx': None,
  'io_wx': None,
  'key': 'name',
  'memory_inactive_file': 6238572544,
  'memory_limit': 8589934592,
  'memory_percent': None,
  'memory_usage': 8527319040,
  'name': 'frigate',
  'network_rx': None,
  'network_tx': None,
  'ports': '5000->5000/tcp,8554->8554/tcp,8555->8555/tcp,8555->8555/udp,8971->8971/tcp',
  'status': 'healthy',
  'uptime': 'an hour'}, ...]
core          [OK]    0.00049s 
{'log': 16, 'phys': 12}
cpu           [OK]    0.00035s 
{'cpucore': 16,
 'ctx_switches': 0,
 'ctx_switches_gauge': 275994786,
 'ctx_switches_rate_per_sec': 0,
 'guest': 0.0,
 'idle': 80.5,
 'interrupts': 0,
 'interrupts_gauge': 89620229,
 'interrupts_rate_per_sec': 0,
 'iowait': 1.2,
 'irq': 0.0,
 'nice': 0.4,
 'soft_interrupts': 0,
 'soft_interrupts_gauge': 85380031,
 'soft_interrupts_rate_per_sec': 0,
 'steal': 0.0,
 'syscalls': 0,
 'syscalls_gauge': 0,
 'syscalls_rate_per_sec': 0,
 'system': 7.5,
 'time_since_update': 2.1413350105285645,
 'total': 18.3,
 'user': 9.2}
diskio        [OK]    0.00072s key=disk_name 
[{'disk_name': 'nvme0n1',
  'key': 'disk_name',
  'read_bytes': 0,
  'read_bytes_gauge': 2452604928,
  'read_bytes_rate_per_sec': 0,
  'read_count': 0,
  'read_count_gauge': 101283,
  'read_count_rate_per_sec': 0,
  'read_latency': 0,
  'read_time': 0,
  'read_time_gauge': 9926,
  'read_time_rate_per_sec': 0,
  'time_since_update': 2.1707005500793457,
  'write_bytes': 0,
  'write_bytes_gauge': 1290231808,
  'write_bytes_rate_per_sec': 0,
  'write_count': 0,
  'write_count_gauge': 84294,
  'write_count_rate_per_sec': 0,
  'write_latency': 0,
  'write_time': 0,
  'write_time_gauge': 16521,
  'write_time_rate_per_sec': 0}, ...]
folders       [OK]    0.00002s 
[]
fs            [OK]    0.02056s key=mnt_point 
[{'device_name': 'tank/docker',
  'free': 1537255931904,
  'fs_type': 'zfs',
  'key': 'mnt_point',
  'mnt_point': '/config',
  'options': 'ro,noatime,xattr,posixacl,casesensitive',
  'percent': 1.0,
  'size': 1552228810752,
  'used': 14972878848}, ...]
gpu           [NA]
help          [OK]    0.00001s 
None
ip            [OK]    0.00443s 
{'address': '***', 'mask': '***', 'mask_cidr': '***'}
irq           [NA]
load          [OK]    0.00018s 
{'cpucore': 16, 'min1': 2.04833984375, 'min15': 1.88671875, 'min5': 1.9462890625}
mem           [OK]    0.00156s 
{'active': 5944614912,
 'available': 25516771304,
 'buffers': 57344,
 'cached': 14841175784,
 'free': 12579860480,
 'inactive': 6276820992,
 'percent': 23.1,
 'percent_max': 23.1,
 'percent_mean': 23.1,
 'percent_min': 23.1,
 'shared': 387674112,
 'total': 33189978112,
 'used': 7673206808}
memswap       [OK]    0.00057s 
{'free': 0, 'percent': 0.0, 'sin': 0, 'sout': 0, 'time_since_update': 2.4561707973480225, 'total': 0, 'used': 0}
mpp           [OK]    0.00007s 
[]
network       [OK]    0.00531s key=interface_name 
[{'alias': None,
  'bytes_all': 5118861,
  'bytes_all_gauge': 32489196585,
  'bytes_all_rate_per_sec': 2398470.0,
  'bytes_recv': 4339677,
  'bytes_recv_gauge': 12489891186,
  'bytes_recv_rate_per_sec': 2033379.0,
  'bytes_sent': 779184,
  'bytes_sent_gauge': 19999305399,
  'bytes_sent_rate_per_sec': 365090.0,
  'interface_name': 'enp86s0',
  'key': 'interface_name',
  'speed': 1048576000,
  'time_since_update': 2.134219169616699}, ...]
now           [OK]    0.00004s 
{'custom': '2026-05-07 18:07:56 BST', 'iso': '2026-05-07T18:07:56+01:00'}
npu           [OK]    0.00005s 
[]
percpu        [OK]    0.00110s key=cpu_number 
[{'cpu_number': 0,
  'dpc': None,
  'guest': 0.0,
  'guest_nice': 0.0,
  'idle': 79.6,
  'interrupt': None,
  'iowait': 0.5,
  'irq': 0.0,
  'key': 'cpu_number',
  'nice': 0.0,
  'softirq': 0.0,
  'steal': 0.0,
  'system': 9.7,
  'total': 20.4,
  'user': 10.2}, ...]
ports         [OK]    0.00003s key=indice 
[{'description': 'DefaultGateway',
  'host': '10.27.0.1',
  'indice': 'port_0',
  'key': 'indice',
  'port': 0,
  'refresh': 30,
  'rtt_warning': None,
  'status': 0.002611,
  'timeout': 3}, ...]
processcount  [OK]    0.17442s 
{'pid_max': 0, 'running': 1, 'sleeping': 501, 'thread': 2770, 'total': 1077}
processlist   [OK]    0.00073s 
[]
programlist   [OK]    0.01328s 
[]
psutilversion [OK]    0.00003s 
'7.2.2'
quicklook     [OK]    0.00056s 
{'cpu': 18.3,
 'cpu_hz': 4000000000.0,
 'cpu_hz_current': 2795008312.5000005,
 'cpu_log_core': 16,
 'cpu_name': '13th Gen Intel(R) Core(TM) i5-1340P',
 'cpu_phys_core': 12,
 'load': 11.8,
 'mem': 23.1,
 'percpu': [{...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...}, {...},
            {...}],
 'swap': 0.0}
raid          [NA]
sensors       [OK]    0.12212s key=label 
[{'critical': 93,
  'key': 'label',
  'label': 'Composite',
  'type': 'temperature_core',
  'unit': 'C',
  'value': 35,
  'warning': 89}, ...]
smart         [OK]    0.00006s 
{}
system        [OK]    0.00001s 
{'hostname': 'nuc13-glances',
 'hr_name': 'Debian GNU/Linux 12 64bit / Linux 6.12.33-production+truenas',
 'linux_distro': 'Debian GNU/Linux 12',
 'os_name': 'Linux',
 'os_version': '6.12.33-production+truenas',
 'platform': '64bit'}
uptime        [OK]    0.00024s 
{'seconds': 6914}
version       [OK]    0.00004s 
'4.5.4'
vms           [OK]    0.00009s 
[]
wifi          [NA]
===============================================================================
Total time to update all stats: 0.43356s
===============================================================================

Additional context
Add any other context about the problem here.

You can also pastebin:

• the Glances configuration file glances.conf
• the Glances log file log

[nicolargo]

In the last docker compose.yaml file the following line is incomplete:

GLANCES_OPT=-C /config/glances.conf -w --password

As you use a non default username (ha instead of glances), you need to add it in the command line option:

GLANCES_OPT=-C /config/glances.conf -w --password --username ha

[janusn]

In the last docker compose.yaml file the following line is incomplete:

GLANCES_OPT=-C /config/glances.conf -w --password

As you use a non default username (ha instead of glances), you need to add it in the command line option:

GLANCES_OPT=-C /config/glances.conf -w --password --username ha

Thanks for looking up this issue. Unfortunately, it does not work either.
The log now reads:

$ docker logs glances
usage: glances [-h] [--print-completion {bash,zsh,tcsh}] [-V] [-d]
               [-C CONF_FILE] [-P PLUGIN_DIR] [--modules-list]
               [--disable-plugin DISABLE_PLUGIN]
               [--enable-plugin ENABLE_PLUGIN] [--disable-process]
               [--disable-webui] [--light] [-0] [-1] [-2] [-3] [-4] [-5] [-6]
               [--disable-history] [--disable-bold] [--disable-bg]
               [--enable-irq] [--enable-process-extended]
               [--disable-separator] [--disable-cursor] [--arrow-keys-sort]
               [--sort-processes {cpu_percent,memory_percent,username,cpu_times,io_counters,name,cpu_num}]
               [--programs] [--export EXPORT]
               [--export-csv-file EXPORT_CSV_FILE] [--export-csv-overwrite]
               [--export-json-file EXPORT_JSON_FILE]
               [--export-graph-path EXPORT_GRAPH_PATH]
               [--export-process-filter EXPORT_PROCESS_FILTER] [-c CLIENT]
               [-s] [--browser] [--disable-autodiscover] [-p PORT]
               [-B BIND_ADDRESS] [-u USERNAME_USED] [--username] [--password]
               [--snmp-community SNMP_COMMUNITY] [--snmp-port SNMP_PORT]
               [--snmp-version SNMP_VERSION] [--snmp-user SNMP_USER]
               [--snmp-auth SNMP_AUTH] [--snmp-force] [-t TIME] [-w]
               [--enable-mcp] [--mcp-path MCP_PATH]
               [--cached-time CACHED_TIME] [--stop-after STOP_AFTER]
               [--open-web-browser] [-q] [-f PROCESS_FILTER]
               [--process-focus PROCESS_FOCUS] [--process-short-name]
               [--process-long-name] [--stdout STDOUT]
               [--stdout-json STDOUT_JSON] [--stdout-csv STDOUT_CSV] [--issue]
               [--trace-malloc] [--memory-leak] [--api-doc]
               [--api-restful-doc] [--hide-kernel-threads] [-b]
               [--diskio-show-ramfs] [--diskio-iops] [--diskio-latency]
               [--fahrenheit] [--fs-free-space] [--sparkline]
               [--disable-unicode] [--hide-public-info]
               [--disable-config-exec] [--disable-check-update]
               [--strftime STRFTIME_FORMAT] [--fetch]
               [--fetch-template FETCH_TEMPLATE]
glances: error: unrecognized arguments: ha

[nicolargo]

My bad it was:

GLANCES_OPT=-C /config/glances.conf -w --password -u ha

I miss read my own documentation :)

[janusn]

Thanks a ton. It works now.

Thanks for your patient.

[nicolargo]

You are welcome. The documentation is not clear, will try to update it.