Koenkk / Koenkk/zigbee2mqtt

Z2M failed start in docker with syntax group_add in docker compose

Open Beginner friendly
#33,091 6 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

problem
Dominant language
TypeScript
Stars
15.7k
Forks
2k
Avg merge
18h 55m
Merged PRs (30d)
35

Description

What happened?

If I use the syntax given in the documentation :
group_add
dialout
user: 1000:1000
the docker did'nt start
load derror in parser ( while parsing a block mapping) at L2C5-L19.C8 did not find expected key

What did you expect to happen?

No response

How to reproduce it (minimal and precise)

No response

Zigbee2MQTT version

latest

Adapter firmware version

can't

Adapter

ember

Setup

Linux raspberrypi 6.18.39+rpt-rpi-v8 #1 SMP PREEMPT Debian 1:6.18.39-1+rpt1 (2026-07-29) aarch64 GNU/Linux

Device database.db entry

bernard@raspberrypi:~/zigbee2mqtt $ cat database.db {"id":1,"type":"Coordinator","ieeeAddr":"0x84b4dbfffec9d466","nwkAddr":0,"manufId":4169,"epList":[1,242],"endpoints":{"1":{"profId":260,"epId":1,"devId":101,"inClusterList":[0,3,6,8,10,25,768],"outClusterList":[0,3,4,5,6,8,32,768,1024,1026,1029,1030,1280,1794,2817,2819,2820,4096],"clusters":{},"binds":[{"cluster":6,"type":"endpoint","deviceIeeeAddress":"0x84b4dbfffec9d466","endpointID":1}],"configuredReportings":[],"meta":{}},"242":{"profId":41440,"epId":242,"devId":102,"inClusterList":[33],"outClusterList":[33],"clusters":{},"binds":[],"configuredReportings":[],"meta":{}}},"interviewCompleted":true,"interviewState":"SUCCESSFUL","meta":{},"lastSeen":1771483461764} {"id":3,"type":"EndDevice","ieeeAddr":"0xe0798dfffef5f1a6","nwkAddr":11385,"manufId":4190,"manufName":"Schneider Electric","powerSource":"Battery","modelId":"CCT591011_AS","epList":[1],"endpoints":{"1":{"profId":260,"epId":1,"devId":1026,"inClusterList":[0,1,3,32,1280,2821],"outClusterList":[0,25],"clusters":{"genBasic":{"attributes":{"modelId":"CCT591011_AS","manufacturerName":"Schneider Electric","powerSource":3,"zclVersion":3,"appVersion":1,"stackVersion":6,"hwVersion":0,"dateCode":"20210611","swBuildId":"2106111"}},"ssIasZone":{"attributes":{"iasCieAddr":"0x84b4dbfffec9d466","zoneState":1,"zoneStatus":48}},"genPollCtrl":{"attributes":{"checkinInterval":14400}}},"binds":[{"cluster":32,"type":"endpoint","deviceIeeeAddress":"0x84b4dbfffec9d466","endpointID":1}],"configuredReportings":[],"meta":{}}},"appVersion":1,"stackVersion":6,"hwVersion":0,"dateCode":"20210611","swBuildId":"2106111","zclVersion":3,"interviewCompleted":false,"interviewState":"FAILED","meta":{},"lastSeen":1781527610886,"checkinInterval":3600} {"id":5,"type":"Router","ieeeAddr":"0xdc8e95fffed95b26","nwkAddr":40578,"manufId":4190,"manufName":"Schneider Electric","powerSource":"Mains (single phase)","modelId":"NHPB/SWITCH/1","epList":[1,21,242],"endpoints":{"1":{"profId":260,"epId":1,"devId":256,"inClusterList":[0,3,4,5,6,2821],"outClusterList":[25],"clusters":{"genBasic":{"attributes":{"modelId":"NHPB/SWITCH/1","manufacturerName":"Schneider Electric","powerSource":1,"zclVersion":3,"appVersion":2,"stackVersion":6,"hwVersion":1,"dateCode":"","swBuildId":"002.010.000 R"}},"genOnOff":{"attributes":{"onOff":0}}},"binds":[{"cluster":6,"type":"endpoint","deviceIeeeAddress":"0x84b4dbfffec9d466","endpointID":1}],"configuredReportings":[{"cluster":6,"attrId":0,"minRepIntval":15,"maxRepIntval":180,"repChange":0}],"meta":{}},"21":{"profId":260,"epId":21,"devId":260,"inClusterList":[0,3,2821,65303],"outClusterList":[3,4,5,6,8,258],"clusters":{"genBasic":{"attributes":{"dateCode":"","modelId":"NHPB/SWITCH/1","manufacturerName":"Schneider Electric","powerSource":1,"zclVersion":3,"appVersion":2,"stackVersion":6,"hwVersion":1,"swBuildId":"002.010.000 R"}}},"binds":[],"configuredReportings":[],"meta":{}},"242":{"profId":41440,"epId":242,"devId":97,"inClusterList":[],"outClusterList":[33],"clusters":{},"binds":[],"configuredReportings":[],"meta":{}}},"appVersion":2,"stackVersion":6,"hwVersion":1,"dateCode":"","swBuildId":"002.010.000 R","zclVersion":3,"interviewCompleted":true,"interviewState":"SUCCESSFUL","meta":{"configured":332242049},"lastSeen":1781527602280} {"id":6,"type":"Router","ieeeAddr":"0x70ac08fffe421106","nwkAddr":31866,"manufId":4190,"manufName":"Schneider Electric","powerSource":"Mains (single phase)","modelId":"EVSCKT/OUTLET/1","epList":[6,242],"endpoints":{"6":{"profId":260,"epId":6,"devId":9,"inClusterList":[0,3,4,5,6,1794,1800,2820,2821,64516],"outClusterList":[25],"clusters":{"genBasic":{"attributes":{"modelId":"EVSCKT/OUTLET/1","manufacturerName":"Schneider Electric","powerSource":1,"zclVersion":3,"appVersion":2,"stackVersion":6,"hwVersion":1,"dateCode":"","swBuildId":"002.010.000 R"}},"genOnOff":{"attributes":{"onOff":1,"startUpOnOff":255}},"haElectricalMeasurement":{"attributes":{"acCurrentDivisor":1000,"acCurrentMultiplier":1,"acVoltageDivisor":1,"acVoltageMultiplier":1,"rmsCurrent":0,"rmsVoltage":237}},"seMetering":{"attributes":{"divisor":1000000,"multiplier":1,"instantaneousDemand":0,"currentSummDelivered":147159000,"ambientConsumptionIndicator":0,"status":0,"extendedStatus":"0"}},"manuSpecificSchneiderFanSwitchConfiguration":{"attributes":{"ledIndication":1}}},"binds":[{"cluster":6,"type":"endpoint","deviceIeeeAddress":"0x84b4dbfffec9d466","endpointID":1},{"cluster":2820,"type":"endpoint","deviceIeeeAddress":"0x84b4dbfffec9d466","endpointID":1},{"cluster":1794,"type":"endpoint","deviceIeeeAddress":"0x84b4dbfffec9d466","endpointID":1}],"configuredReportings":[{"cluster":6,"attrId":0,"minRepIntval":0,"maxRepIntval":65000,"repChange":1},{"cluster":2820,"attrId":1288,"minRepIntval":10,"maxRepIntval":65000,"repChange":50},{"cluster":2820,"attrId":1285,"minRepIntval":10,"maxRepIntval":65000,"repChange":5},{"cluster":1794,"attrId":1024,"minRepIntval":10,"maxRepIntval":65000,"repChange":5000},{"cluster":1794,"attrId":0,"minRepIntval":10,"maxRepIntval":65000,"repChange":100000}],"meta":{}},"242":{"profId":41440,"epId":242,"devId":97,"inClusterList":[],"outClusterList":[33],"clusters":{},"binds":[],"configuredReportings":[],"meta":{}}},"appVersion":2,"stackVersion":6,"hwVersion":1,"dateCode":"","swBuildId":"002.010.000 R","zclVersion":3,"interviewCompleted":true,"interviewState":"SUCCESSFUL","meta":{"configured":"0.0.0"},"lastSeen":1781530917460}

Debug log

No response

Notes

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Search the Docker Compose documentation for the group_add and user configuration example described in the issue. Check the example as a complete Compose YAML document and verify it parses successfully and allows the container to start; done means the documented syntax no longer produces the reported parser error.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker-compose
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
65/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.