dsh-community-plugins

Usage

1. Open Settings → Plugins → Community plugins.
2. Browse the top plugins (by stars), switch between List / Grid, and use the category tags to drill into a topic.
3. Type to search — results come from the local cache instantly, and the host refreshes that query from GitHub in the background. Results then stay put until you edit a filter again; Clear filters puts you back at the unfiltered list.
4. Click a card's fork count to browse that repo's forks, compare one against upstream on GitHub, and install from it if it carries changes you want.
5. Click Install on a plugin. When it finishes, restart dsh web and refresh the page (the note under the result explains this). Newly installed plugins appear in the built-in Plugin list tab after the restart.

Configuration

Environment variables (all optional):

Variable	Default	Purpose
DSH_COMMUNITY_PROFILE	auto-detected	The profile to install into. Falls back to DSH_PROFILE, then auto-detection, then web.
DSH_PROFILE	—	Fallback profile name when DSH_COMMUNITY_PROFILE is unset.
DSH_BIN	dsh on PATH	Full path to the dsh executable used for install/uninstall.
DSH_COMMUNITY_INCLUDE_FORKS	unset	Any non-empty value includes GitHub forks in the catalog (forks are excluded by default).
DSH_COMMUNITY_MIN_FETCH_INTERVAL_MS	6000	Minimum gap between GitHub fetches, to stay under the search rate limit.
DSH_COMMUNITY_FORKS_TTL_MS	600000	How long cached fork listings and GitHub repo metadata are served before GitHub is asked again. The REST endpoints use GitHub's core limit (60/hr unauthenticated), separate from search.
DSH_COMMUNITY_GITHUB_TOKEN	—	Optional bearer token (falls back to GITHUB_TOKEN) sent with GitHub API requests — lets the fork browser and local-plugin metadata reach private repos you have access to.
DSH_COMMUNITY_RESTART_CMD	—	Overrides the restart command (e.g. systemctl restart dsh-web). Default: re-exec this process's own command line.

Profile auto-detection finds the profile whose dsh.profile.bundles includes this plugin, so a custom profile hosting the web GUI works without any configuration.