Marketplace

A marketplace is a plugin registry: a URL that serves a manifest JSON listing available plugins. Users add marketplace URLs to their Pipe Bomb instance to browse and install plugins from a curated source.

Adding a marketplace

Go to Settings → System → Plugin Marketplace → Add marketplace, and paste the URL of a marketplace manifest. The server fetches and validates the manifest immediately; if it's unreachable or invalid the URL is rejected.

Manifests are cached for 5 minutes so that browsing the marketplace doesn't hammer the remote server.

Marketplace manifest format

A marketplace manifest is a JSON file served at the marketplace URL. It must satisfy:

{
	"name": "My Plugin Registry",
	"plugins": [
		{
			"id": "my-plugin",
			"name": "My Plugin",
			"description": "Optional description",
			"authorName": "Author Name",
			"authorUrl": "https://...",
			"repository": "https://github.com/author/my-plugin",
			"url": "https://github.com/author/my-plugin"
		}
	]
}

id - must match the name field in the plugin's package.json
repository - the git URL used to clone and install the plugin
url - optional link shown in the UI (e.g., homepage or docs)

Installing from the marketplace

The Plugin Marketplace page shows all plugins listed across all added marketplaces, with an "installed" badge on plugins already present. Clicking "Install" triggers the standard plugin installation flow: the server clones the repository, builds if necessary, and loads the plugin.

Installing plugins manually

Plugins can also be installed directly from a git URL via Settings → System → Installed Plugins → Install plugin. No marketplace is required. This is useful for private plugins or plugins not listed in any public registry.

Hosting a marketplace

To host your own marketplace, serve a valid manifest JSON file at any stable HTTPS URL. Keep id values stable - they are used as plugin identifiers throughout the system.