Skip to content

group

mdocker group assigns a project to a sidebar group. Groups are implicit: a group exists as long as at least one project carries it in the registry field group. There is no create and no rm — assigning the last project away makes the group disappear.

The macOS app renders these groups as collapsible sections in its sidebar. See Project Groups.

Assign a project to a group, or remove the assignment by omitting the group.

mdocker group set
mdocker group set <project> [<group>]
examples
mdocker group set aurora "Acme Corp"
# ok Projekt 'aurora' -> Gruppe 'Acme Corp'
mdocker group set aurora
# ok Gruppe fuer 'aurora' entfernt.

The group name is trimmed; a value that is only whitespace counts as empty and deletes the key. An unknown project name aborts with Projekt '<name>' unbekannt.

Print the group of a single project (read-only).

mdocker group show
mdocker group show <project>
mdocker --json group show <project>

Plain text prints the group name, or (keine Gruppe) when none is set. JSON:

{ "project": "aurora", "group": "Acme Corp" }

group is null when the project has no group.

List every group with its projects (read-only). list is an alias.

mdocker group ls
mdocker group ls
mdocker --json group ls
GRUPPE PROJEKTE
Acme Corp aurora, demo-shop
Internal docs-site

With no group assigned anywhere, the command warns instead of printing a table: Keine Gruppen vergeben. mdocker group set <projekt> <gruppe>.

JSON:

[
{ "group": "Acme Corp", "projects": ["aurora", "demo-shop"] },
{ "group": "Internal", "projects": ["docs-site"] }
]
Situation Message
No subverb Nutzung: mdocker group set <projekt> [<gruppe>] | show <projekt> | ls
Unknown subverb Unbekannte group-Aktion: X (erwartet: set|show|ls)
Unknown project Projekt '<name>' unbekannt.

The assignment lives in .projects[<name>].group and is also exposed by mdocker --json ls (null when unset). See Registry & State.