FAQs
1. Not receiving reset password emails
You need to configure the Mail
parameters in the .env
file. For detailed instructions, please refer to “Environment Variables Explanation: Mail-related configuration”.
After modifying the configuration, run the following commands to restart the service:
If you still haven’t received the email, please check if the email service is working properly and whether the email has been placed in the trash list.
2. How to handle if the workflow is too complex and exceeds the node limit?
In the community edition, you can manually adjust the MAX_TREE_DEPTH limit for single branch depth in web/app/components/workflow/constants.ts.
Our default value is 50, and it’s important to note that excessively deep branches may affect performance in self-hosted scenarios.
3. How to specify the runtime for each workflow node?
You can modify the TEXT_GENERATION_TIMEOUT_MS
variable in the .env
file to adjust the runtime for each node. This helps prevent overall application service unavailability caused by certain processes timing out.
4. How to reset the password of the admin account?
If you deployed using Docker Compose, you can reset the password with the following command while your Docker Compose is running:
It will prompt you to enter the email address and the new password. Example:
5. How to Change the Port
If you’re using Docker Compose, you can customize the access port by modifying the .env
configuration file.
You need to modify the Nginx configuration:
Other self-host issue please check this document Self-Host Related。
6. How to resolve database connection errors in docker-api-1?
Issue Details: When accessing http://localhost
, you may encounter an Internal Server Error
; and the following message might appear in the docker-api-1
logs:
Solution: Update the /var/lib/postgresql/pgdata/pg_hba.conf
file inside the db container to allow connections from the network segment mentioned in the error message. For example:
7. How to change the file size limit for knowledge base uploads?
Modify the UPLOAD_FILE_SIZE_LIMIT
parameter in the .env
file to adjust the default limit. Additionally, you should also sync the NGINX_CLIENT_MAX_BODY_SIZE
parameter value to avoid potential issues.
8. How to create a backup before upgrading?
Before upgrading, it is recommended to back up your current dify
directory to prevent any potential data loss. You can create a backup with the following command:
This will create a timestamped backup copy, making it easy to restore if needed.
9. How to install an older version of the Community Edition?
In some cases, you may want to install a specific older version of the Community Edition, you can use the --branch
flag to do this. For example, to install version 0.15.3
:
This will clone the repository at that version, and the rest of the setup is the same as installing the latest version.
10. How to install the Community Edition using a ZIP archive?
If you’re on a network-restricted server or unable to use git
for any reason, you can install Dify using a ZIP archive:
The remaining installation steps are the same as in the standard setup. Alternatively, you can download the ZIP archive on another device and manually upload it to the target server.
To upgrade later, download the latest archive and synchronize it with your existing installation: