Skip to main content
Version: Next

Troubleshooting

Common issues and quick fixes for ashell.

NVIDIA Driver Issues​

Problem: ashell freezes on startup with NVIDIA graphics.

Solution: Add to your ashell config:

[renderer]
backend = "egl"

If still broken: Try different NVIDIA drivers or use a different compositor.

Idle Inhibitor Issues​

Problem: Screen sleeps even when ashell is running.

Cause: This is a swayidle bug in version 1.9.0+ with BlockInhibited property parsing.

Solutions:

  • Downgrade swayidle to 1.8.x
  • Wait for swayidle fix upstream
  • Use alternative idle management tools like hypridle

Missing Tray Icons​

Problem: Telegram doesn't appear in tray when ashell starts after Telegram.

Cause: Telegram doesn't re-register with tray services if ashell starts afterward.

Solutions:

  • Start Telegram after ashell
  • Restart Telegram after starting ashell

Debug Mode​

Run with debug logging to find issues:

RUST_LOG=debug ashell

Get Help​

Include this info when reporting issues:

  • OS and compositor
  • GPU/driver info
  • Full debug logs
  • Your ashell config