Troubleshooting
Fix a DSH plugin installed but not active
A DSH plugin installed but not active usually points to the wrong profile, missing configuration, disabled registration, or a startup error after installation.
01
Separate installed from loaded
Package presence only proves files were resolved. Confirm that the intended profile registers the plugin and that startup reaches its entry point.
- Check the active profile
- Inspect registration and configuration
- Read startup logs after installation
02
Verify the capability itself
Some plugins load without exposing a visible command or UI until configuration is complete. Test the documented capability rather than relying on package presence.
- Use the upstream usage example
- Check required credentials through approved secret injection
- Restart only when documentation requires it
Review sources
Sources help verify current facts. Their inclusion does not imply endorsement of this page.
DSH plugin installed but not active questions
Why is my DSH plugin installed but not active?
Installed means the package resolved onto disk, while active means the running profile registered it, startup reached its entry point, and nothing threw. A plugin can be perfectly installed and never load.
Why is there no error message at all?
Plugins that require configuration often register successfully and then do nothing until they are configured. Silence usually means a missing setting rather than a crash.
How do I confirm the plugin actually loaded?
Look for the plugin's own registration line in the startup log, then exercise one capability its README documents. Confirming that the package folder exists proves nothing about loading.
Do I need to restart after installing?
Only when the upstream documentation says so. Restarting reflexively burns a debugging cycle and hides whether the plugin loads on a cold start at all.
Can a DSH plugin installed but not active simply be disabled?
Yes. Some profiles keep an explicit enable list, and some plugins ship disabled until a required setting is present. Check the profile configuration before you start reading the plugin's code.