> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Package as Local File and Share

> Package a Dify plugin into a `.difypkg` file you can install directly or hand off to others, with no marketplace or GitHub release required

A `.difypkg` is the portable form of a Dify plugin. Once you have one, anyone can install it through the Plugins page by uploading the file. This is the right path for **private plugins**, **internal testing**, or **out-of-band distribution** to a small group.

For wider distribution, see the [Publishing Overview](https://enterprise-docs.dify.ai/en/3.13.x/develop/plugins/publishing/marketplace-listing/release-overview.md).

## Prerequisites

* The [Dify Plugin CLI](https://enterprise-docs.dify.ai/en/3.13.x/develop/plugins/getting-started/cli.md) installed. Run `dify version` to confirm.
* A completed plugin project. If you haven't built one yet, start with the [Tool Plugin walkthrough](https://enterprise-docs.dify.ai/en/3.13.x/develop/plugins/dev-guides-and-walkthroughs/tool-plugin.md).
* The plugin tested with [remote debugging](https://enterprise-docs.dify.ai/en/3.13.x/develop/plugins/features-and-specs/plugin-types/remote-debug-a-plugin.md) before packaging.

> [!NOTE]
>
> The `author` field in `manifest.yaml` and every `provider/*.yaml` must match your GitHub handle. Mismatches cause `plugin_unique_identifier is not valid` at install time. See [General Specifications](https://enterprise-docs.dify.ai/en/3.13.x/develop/plugins/features-and-specs/plugin-types/general-specifications.md) for the full manifest spec.

## Package the Plugin

**1. Move above the project**

Navigate to the directory **above** your plugin project (so the project is a subdirectory of the current working directory).

**2. Run the packager**

```bash theme={null}
dify plugin package ./your_plugin_project
```

The CLI produces a `your_plugin_project.difypkg` file in the current directory.

![Generated Plugin File](https://assets-docs.dify.ai/2024/12/98e09c04273eace8fe6e5ac976443cca.png)

## Install from the File

**1. Open the Plugins page**

In Dify, click the **Plugins** icon in the top-right corner.

**2. Choose Install Plugin > Via Local File**

Or drag the `.difypkg` onto the empty area of the Plugins page.

**3. Confirm the install**

Review the permissions the plugin requests, then click **Install**.

![Install Plugin File](https://assets-docs.dify.ai/2024/12/8c31c4025a070f23455799f942b91a57.png)

> [!TIP]
>
> The plugin is now in the workspace and ready to use in Agents, Workflows, or Tools. No further action required.

> [!WARNING]
>
> Self-hosted Dify enforces signature verification by default. Unsigned `.difypkg` files installed via Local File will be rejected unless you sign them or change the verification setting. See [Third-Party Signature Verification](https://enterprise-docs.dify.ai/en/3.13.x/develop/plugins/publishing/standards/third-party-signature-verification.md).

## Share the File

Hand the `.difypkg` file to your users directly: over email, an internal file share, or any channel you control. They install it with the same flow above.

If you want broader distribution instead, consider:

> [card] [Publish on GitHub](https://enterprise-docs.dify.ai/en/3.13.x/develop/plugins/publishing/marketplace-listing/release-to-individual-github-repo.md)
>
> Attach the `.difypkg` to a GitHub release; users install via repo URL.

> [card] [Publish to Marketplace](https://enterprise-docs.dify.ai/en/3.13.x/develop/plugins/publishing/marketplace-listing/submit-plugin-to-marketplace.md)
>
> Open a PR against `langgenius/dify-plugins` for the official catalog.

## Related Resources

* [Publishing Overview](https://enterprise-docs.dify.ai/en/3.13.x/develop/plugins/publishing/marketplace-listing/release-overview.md)
* [Dify Plugin CLI](https://enterprise-docs.dify.ai/en/3.13.x/develop/plugins/getting-started/cli.md)
* [Remote Debugging](https://enterprise-docs.dify.ai/en/3.13.x/develop/plugins/features-and-specs/plugin-types/remote-debug-a-plugin.md)
* [Third-Party Signature Verification](https://enterprise-docs.dify.ai/en/3.13.x/develop/plugins/publishing/standards/third-party-signature-verification.md)
* [General Specifications](https://enterprise-docs.dify.ai/en/3.13.x/develop/plugins/features-and-specs/plugin-types/general-specifications.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.