First Plugin Upload

This guide walks you through uploading your first PF4J plugin to Plugwerk.

Prerequisites

• A running Plugwerk instance (see Quickstart)
• A PF4J plugin JAR with a valid MANIFEST.MF

Plugin Descriptor

Plugwerk reads plugin metadata from the standard Java MANIFEST.MF inside the plugin JAR. Required attributes:

Attribute	Purpose
Plugin-Id	Unique plugin identifier
Plugin-Version	SemVer version (e.g. 1.0.0)

See Plugin Descriptor for the full attribute reference.

Upload Steps

1. Navigate to your namespace

   Open the Plugwerk Web UI and select the namespace where you want to upload the plugin.

2. Upload the plugin

   Click “Upload Plugin” and select your plugin JAR or ZIP file.

   Plugwerk will:

   • Parse the MANIFEST.MF descriptor
   • Validate the plugin ID and version
   • Compute a SHA-256 checksum
   • Create the plugin entry (if new) and a release

3. Publish the release

   New releases start in draft status. If your namespace requires review, the release enters a review queue. Otherwise, click “Publish” to make it available.

Verify via API

curl http://localhost:8080/api/v1/namespaces/default/plugins

Your plugin should appear in the catalog response.