docs: adapt for the new start script by Stream29 · Pull Request #768 · langgenius/dify-docs

Stream29 · 2026-04-29T21:01:03Z

No description provided.

mintlify · 2026-04-29T21:01:06Z

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
dify-core-product	🟢 Ready	View Preview	Apr 29, 2026, 9:03 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Copilot

Pull request overview

Updates the self-hosting documentation to reflect using the new Docker Compose “wrapper” start script instead of calling Docker Compose directly.

Changes:

Replace manual .env copy + docker compose up instructions with dify-compose / dify-compose.ps1 wrapper commands.
Update environment variable reference to reflect wrapper-generated SECRET_KEY.
Document MAIL_TYPE as optional (empty disables email sending).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
en/self-host/quick-start/docker-compose.mdx	Switch quick-start commands to the new compose wrapper and update restart/upgrade guidance.
en/self-host/configuration/environments.mdx	Adjust documented defaults/behavior for `SECRET_KEY` and `MAIL_TYPE`, plus minor formatting.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

github-actions · 2026-04-29T21:05:19Z

🌐 Multi-language Sync

✅ Created sync PR #769

Synced 2 files to cn + jp

Both PRs can merge independently. Future commits here will auto-update the sync PR.

…eploy # Conflicts: # en/self-host/quick-start/docker-compose.mdx

RiskeyL · 2026-05-06T13:18:15Z

#35708

Stream29 · 2026-05-07T06:28:26Z

@RiskeyL langgenius/dify#35708 is merged. This doc update is ready to merge.

RiskeyL · 2026-05-07T09:25:09Z

@Stream29 Thx. I'll handle the rest and complete the merge today.

Copilot

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

…ranslate zh/ja

RiskeyL · 2026-05-07T13:17:54Z

Hi @Stream29, a few things from my side:

Translations: The auto-translation workflow has some issues right now, so I've manually translated the zh/ja docs in this PR. I'll close the associated auto-sync PR.
Doc updates after testing: I ran through the new deployment flow end-to-end and made some refinements: clearer first-run prompt walkthrough, exposition of the three-file model (.env, .env.default, .env.example), and the conditional MAIL_DEFAULT_SEND_FROM fix per Copilot feedback. Please take a look when you have a moment.
Release timing: The deployment guide directs users to clone the latest release tag, not main. The dify-compose script and .env.default from #35708 only become reachable for users once shipped in a release, so this docs PR's merge should align with that release. Could you confirm which version of Dify will include #35708?

Stream29 · 2026-05-07T13:31:31Z

@RiskeyL Thank you for the translation work!

Your revision is reasonable and correct.
This document update has no relation with Dify CE releasing. As the PR chore: easier and simpler deploy dify#35708 is merged, the new deployment shorthand is available already.

RiskeyL · 2026-05-07T14:13:13Z

@Stream29 I take the point that #35708 is merged into main, but the deployment guide pins the clone to the latest release tag (not main):

git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git

I just cloned the latest release in a fresh directory and confirmed docker/dify-compose, docker/dify-compose.ps1, and docker/.env.default are all missing. A user following the docs today would land on a clone without the wrapper script or .env.default, so the rest of the deployment steps would fail.

Keeping the clone command pinned to the latest release is the right call (releases are stable, main isn't), so the cleanest path is to merge this docs PR alongside the release that ships #35708. Could you confirm which Dify version that will be?

Stream29 · 2026-05-07T14:17:30Z

OK. I will announce you when I get further information.

Stream29 · 2026-05-08T02:54:18Z

The next release date is estimated on next Mon. or Tue..

Stream29 · 2026-05-08T09:59:01Z

@RiskeyL According to langgenius/dify#35708 (comment), this PR needs update.

Copilot

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

+          ```bash macOS/Linux/WSL
+          ./init-env.sh
+          ```
+          ```powershell Windows PowerShell


+          .\init-env.ps1
+          ```
+        </CodeGroup>



+          ```powershell Windows PowerShell
+          .\init-env.ps1
+          ```
+        </CodeGroup>



Stream29 · 2026-05-08T12:45:27Z

@RiskeyL according to langgenius/dify#31586, this PR
can be closed.

docs: adapt for the new start script

4c87ba3

Stream29 requested a review from RiskeyL as a code owner April 29, 2026 21:01

Copilot AI review requested due to automatic review settings April 29, 2026 21:01

dosubot Bot added the size:M This PR changes 30-99 lines, ignoring generated files. label Apr 29, 2026

Copilot started reviewing on behalf of Stream29 April 29, 2026 21:01 View session

dosubot Bot added the documentation Improvements or additions to documentation label Apr 29, 2026

mintlify Bot deployed to staging April 29, 2026 21:03 View deployment

Copilot AI reviewed Apr 29, 2026

View reviewed changes

Comment thread en/self-host/quick-start/docker-compose.mdx Outdated

Comment thread en/self-host/configuration/environments.mdx

Comment thread en/self-host/configuration/environments.mdx Outdated

github-actions Bot mentioned this pull request Apr 29, 2026

🌐 Sync PR #768 translations: docs: adapt for the new start script #769

Closed

Merge remote-tracking branch 'origin/main' into feat/easier-simpler-d…

e388eb4

…eploy # Conflicts: # en/self-host/quick-start/docker-compose.mdx

dosubot Bot added size:L This PR changes 100-499 lines, ignoring generated files. and removed size:M This PR changes 30-99 lines, ignoring generated files. labels May 4, 2026

mintlify Bot deployed to staging May 4, 2026 19:21 View deployment

docs: remove translation changes

e963f73

Copilot AI review requested due to automatic review settings May 7, 2026 09:23

dosubot Bot added size:M This PR changes 30-99 lines, ignoring generated files. and removed size:L This PR changes 100-499 lines, ignoring generated files. labels May 7, 2026

Copilot started reviewing on behalf of Stream29 May 7, 2026 09:23 View session

mintlify Bot deployed to staging May 7, 2026 09:24 View deployment

Copilot AI reviewed May 7, 2026

View reviewed changes

Comment thread en/self-host/configuration/environments.mdx

docs: refine docker-compose deployment guide and env var reference; t…

490ee0c

…ranslate zh/ja

dosubot Bot added size:L This PR changes 100-499 lines, ignoring generated files. and removed size:M This PR changes 30-99 lines, ignoring generated files. labels May 7, 2026

mintlify Bot deployed to staging May 7, 2026 13:10 View deployment

RiskeyL changed the base branch from main to release/1.14.1 May 8, 2026 07:38

kurokobo mentioned this pull request May 8, 2026

chore: simpler docker deploy — drop wrapper script, x-shared-env anchor, and template generator langgenius/dify#35927

Draft

7 tasks

docs: update from langgenius/dify#35708 (comment)

62e3c33

Copilot AI review requested due to automatic review settings May 8, 2026 09:59

Copilot started reviewing on behalf of Stream29 May 8, 2026 10:00 View session

mintlify Bot deployed to staging May 8, 2026 10:01 View deployment

Copilot AI reviewed May 8, 2026

View reviewed changes

Stream29 closed this May 8, 2026

Conversation

Stream29 commented Apr 29, 2026

Uh oh!

mintlify Bot commented Apr 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Apr 29, 2026

🌐 Multi-language Sync

Uh oh!

RiskeyL commented May 6, 2026

Uh oh!

Stream29 commented May 7, 2026

Uh oh!

RiskeyL commented May 7, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

RiskeyL commented May 7, 2026

Uh oh!

Stream29 commented May 7, 2026

Uh oh!

RiskeyL commented May 7, 2026

Uh oh!

Stream29 commented May 7, 2026

Uh oh!

Stream29 commented May 8, 2026

Uh oh!

Stream29 commented May 8, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Stream29 commented May 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

mintlify Bot commented Apr 29, 2026 •

edited

Loading