Start with what you can see.

Run diagnostics

dwarfsctl --version
dwarfsctl doctor

doctor reports the engine, required system helpers, configuration and session services. Run it from the same desktop account where the problem occurs.

Dolphin does not show the icon or actions

1. Confirm the package matches your distribution.
2. Log out and back in after the first installation.
3. Confirm Dolphin identifies the file as a DwarFS filesystem image.
4. If you changed its default application earlier, choose Open DwarFS Image from Open With and save it as the default.

After an upgrade, restart Dolphin and the DwarFSctl tray. A full logout is rarely necessary after the initial installation.

A mounted image is not under Devices

DwarFSctl volumes appear in Places. Plasma reserves Devices and Removable Devices for hardware represented by Solid and UDisks. A DwarFS image is a userspace FUSE mount, so presenting it as hardware would be misleading.

If the Places entry is missing, inspect the image:

dwarfsctl mount status ./archive.dwarfs

Unmount through the tray before removing or upgrading the package.

Image problems

Check integrity

Choose Check Integrity… in Dolphin or run:

dwarfsctl fsck ./archive.dwarfs

No modification times while browsing

The mountless dwarfs: view exposes names, sizes and permissions but not timestamps. Mount the image to access its filesystem timestamps.

A destination already exists

DwarFSctl protects existing files and directories. Choose a new destination or explicitly confirm replacement where the interface offers it.

Report a problem

Include the DwarFSctl version, distribution, Plasma version, the action you chose, the visible error and the output from dwarfsctl doctor. Remove personal paths or image contents that are not needed to reproduce the problem.

Use GitHub Issues for ordinary bugs. Report vulnerabilities through the private security advisory form.