Docs · Documentation

Troubleshooting

Common issues by symptom. If your problem isn't listed, vinos-doctor is a good first move.

Every symptom below has been seen on real hardware — either during alpha testing, in issue reports, or during the maintainer’s own daily use.

Wi-Fi on T2 MacBooks — the 8-item recipe that gets Broadcom firmware working reliably.
Docker not running — lazydocker “Cannot connect” fixes.
Theme picker empty — historic issue, fixed since v2.0.3; here for older installs.

Before you file an issue, please attach:

$ vinos-doctor > /tmp/doctor.log
$ vinos-hw-report > /tmp/hw.md

Those two together let us reproduce and answer without a back-and-forth.

The 8-item recipe for Broadcom BCM4364/4377 Wi-Fi on Intel-Mac T2 laptops. Verified since the 2026-07-15 baseline ISO.

lazydocker's 'Cannot connect to Docker daemon' and Disk Usage launcher fixes.

Historic issue where vinos-theme --pick showed no options on first launch. Fixed in v2.0.3 with cache pre-warm; here for older installs.