How to install pkg offline?

[AdaChamberss]

Self Checks

• I have searched for existing issues search for existing issues, including closed ones.
• I confirm that I am using English to submit this report (我已阅读并同意 Language Policy).
• [FOR CHINESE USERS] 请务必使用英文提交 Issue，否则会被关闭。谢谢！:)
• Please do not modify this template :) and fill in all the required fields.

Content

How to install a plugin offline for the 2 nginx layer condition?
I upload a local difypakg and click install. The plugin docker raised an error:

2025/11/03 01:49:00 /app/internal/db/executor.go:259 record not found
[1.237ms] [rows:0] SELECT * FROM "plugins" WHERE plugin_unique_identifier = 'langgenius/openai:0.2.6@e2665624a156f52160927bceac9e169bd7e5ae6b936ae82575e14c90af390e6e' ORDER BY "plugins"."id" LIMIT 1
[GIN] 2025/11/03 - 01:49:00 | 200 | 39.457843ms | 192.168.48.7 | POST "/plugin/3d178871-1256-4b6e-85d6-955ed810d225/management/install/identifiers"
[GIN] 2025/11/03 - 01:49:00 | 200 | 869.964µs | 192.168.48.7 | GET "/plugin/3d178871-1256-4b6e-85d6-955ed810d225/management/install/tasks/76cc26b0-d6fc-415b-a9f2-969d9ec0096a"
[GIN] 2025/11/03 - 01:49:00 | 200 | 831.122µs | 192.168.48.7 | GET "/plugin/3d178871-1256-4b6e-85d6-955ed810d225/management/install/tasks?page=1&page_size=100"
2025/11/03 01:49:00 full_duplex.go:27: [INFO]new plugin logged in: langgenius/openai:0.2.6
2025/11/03 01:49:00 full_duplex.go:59: [INFO]init environment for plugin langgenius/openai:0.2.6
[GIN] 2025/11/03 - 01:49:10 | 200 | 962.815µs | 192.168.48.7 | GET "/plugin/3d178871-1256-4b6e-85d6-955ed810d225/management/install/tasks/76cc26b0-d6fc-415b-a9f2-969d9ec0096a"
[GIN] 2025/11/03 - 01:49:21 | 200 | 808.08µs | 192.168.48.7 | GET "/plugin/3d178871-1256-4b6e-85d6-955ed810d225/management/install/tasks/76cc26b0-d6fc-415b-a9f2-969d9ec0096a"
[GIN] 2025/11/03 - 01:49:32 | 200 | 784.495µs | 192.168.48.7 | GET "/plugin/3d178871-1256-4b6e-85d6-955ed810d225/management/install/tasks/76cc26b0-d6fc-415b-a9f2-969d9ec0096a"
[GIN] 2025/11/03 - 01:49:40 | 200 | 748.39µs | 192.168.48.7 | GET "/plugin/3d178871-1256-4b6e-85d6-955ed810d225/management/install/tasks?page=1&page_size=100"
2025/11/03 01:49:42 full_duplex.go:65: [ERROR]init environment failed: failed to install dependencies: exit status 2, output: error: Failed to fetch: https://pypi.org/simple/numpy/
Caused by: Request failed after 3 retries
Caused by: error sending request for url (https://pypi.org/simple/numpy/)
Caused by: client error (Connect)
Caused by: dns error
Caused by: failed to lookup address information: Temporary failure in name resolution
, retrying
2025/11/03 01:49:42 full_duplex.go:59: [INFO]init environment for plugin langgenius/openai:0.2.6

Seems it was installing dependencies online, but the server does not have internet. Can I install everything on a machine with internet and then upload everything once to the server?

[dosubot[bot]]

To install a Dify plugin offline, you need to prepare a plugin package that includes all its dependencies, since the default install process tries to fetch them from the internet (like PyPI), which fails without connectivity. The recommended workflow is:

1. On a machine with internet access, use the dify-plugin-repackaging tool to download all required dependencies and bundle them into a new .difypkg file. This ensures all wheels and packages are included for offline use (details).
2. Transfer the offline .difypkg to your server and use Dify's "install from local package" option. This skips online fetching and installs everything from the bundle (details).
3. If you encounter signature verification errors, set FORCE_VERIFYING_SIGNATURE=false in your .env file and restart Dify containers (details).
4. If you need the plugin to run fully offline, set INSTALL_METHOD=local in the plugin environment (details).

Note: Copying only plugin files or the volumes folder does not migrate database state (tenants, providers, models). You may need to manually create or migrate these records for full functionality (details).

There is no built-in automated way to convert remote dependencies to local ones; the plugin bundle must be complete and self-contained for offline installation (details).

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[AdaChamberss]

I've bundled a .difypkg file. However it stuck when upload from local. Maybe I could upload the difypkg file manually to the server. So what path should I uplaod the difypkg file to so that dify can find it?
@dosu.

[AdaChamberss]

I've bundled a .difypkg file. However it stuck when upload from local. Maybe I could upload the difypkg file manually to the server. So what path should I uplaod the difypkg file to so that dify can find it?
@dosu.

[dosubot[bot]]

Dify does not automatically detect .difypkg files placed directly on the server. The supported method is to upload the .difypkg file using the "Install from local file" option in the Dify web UI or API. If the UI upload is stuck, you can try manually placing the file in the plugin daemon's storage directory, which is usually ./volumes/plugin_daemon/plugin_packages on the host (mapped to /app/storage/plugin_packages in the container). After placing the file, restart the plugin_daemon service to give Dify a chance to recognize it, but this method is not officially documented and may not always work as expected. The recommended and most reliable approach remains uploading via the UI or API. If you encounter signature verification errors, set FORCE_VERIFYING_SIGNATURE=false in your .env file and restart Dify containers to bypass the check. For large plugins, you may also need to increase PLUGIN_MAX_PACKAGE_SIZE and NGINX_CLIENT_MAX_BODY_SIZE in your .env file.
Reference

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[AdaChamberss]

I Uploaded in Dify UI. However I found an error in the browser's request. The browser requests 'http://10.142.157.36:8080/dify/console/api/workspaces/current/plugin/upload/pkg'. It failed with a status '(failed)net::ERR_CONTENT_LENGTH_MISMATCH'.

@dosu

[dosubot[bot]]

The error net::ERR_CONTENT_LENGTH_MISMATCH means the browser expected to upload a certain number of bytes, but the server or a proxy (like NGINX) closed the connection early or rejected the upload because of a size/configuration mismatch. This is common when uploading large files if the upload size limits are not set consistently across all layers.

To fix this, make sure the following are set to a value larger than your .difypkg file size (for example, 500M or more):

• In your Dify .env file:

  PLUGIN_MAX_PACKAGE_SIZE=524288000
  NGINX_CLIENT_MAX_BODY_SIZE=500M
  

• In both NGINX layers (if you have two), set in your nginx.conf:

  client_max_body_size 500M;
  

  and reload/restart NGINX after changing.

All proxies and the Dify backend must allow the same (or larger) upload size, or the upload will fail with this error. After making these changes, restart all related services and try the upload again. If it still fails, check the NGINX and Dify backend logs for more details, and try uploading a smaller file to confirm if the issue is strictly size-related.

References:
1
2

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}