Filesystem layout

Generated Markdown for references/fact_paths_table.md.

Open book page Back to the skill graph

# Filesystem layout

All XDG paths respect their environment variables.

| Path | Contents |
| --- | --- |
| `<labdir>/vmlab.wcl` | Lab definition — found by walking up from cwd |
| `<labdir>/.vmlab/` | Lab-local working data: linked clones, snapshots, built media, screenshots (gitignore it) |
| `~/.local/share/vmlab/templates/<arch>/<name>/<version>/` | Template store (`disk.qcow2` + `template.wcl`) |
| `~/.cache/vmlab/artefacts/` | Downloaded ISO/qcow2 + built-media cache (content-addressed) |
| `~/.local/state/vmlab/` | Daemon state + logs (`vmlabd.log`, per-lab/per-VM JSON-line logs) |
| `~/.config/vmlab/config.wcl` | Host config (optional) |
| `~/.config/vmlab/profiles/*.wcl` | User profile overrides/additions |
| `$XDG_RUNTIME_DIR/vmlab/vmlabd.sock` | Supervisor socket (fallback `/tmp/vmlab-<uid>/`) |
| `$XDG_RUNTIME_DIR/vmlab/labs/<lab>/control.sock` | Lab daemon socket (+ per-VM QMP/agent/NIC/VNC sockets beside it) |

## Related

- [Host config](../references/concept_host_config.md)

- [Template store](../references/entity_template_store.md)

- [.vmlab/](../references/entity_dot_vmlab.md)

[← Back to SKILL.md](../SKILL.md)