docs(migration): note shell reload and browser restart after v1 upgrade#207
Merged
Conversation
mawiswiss
force-pushed
the
docs/migration-v1-shell-and-browser
branch
from
June 11, 2026 12:00
7428b53 to
9ed3b1f
Compare
xarem
requested changes
Jun 11, 2026
mawiswiss
force-pushed
the
docs/migration-v1-shell-and-browser
branch
from
June 18, 2026 12:38
9ed3b1f to
2d443ed
Compare
Two steps that are easy to miss when moving from dde v1 and that make system:install or the TLS setup look broken: - After removing the v1 shell integration, the current session still has the v1 dde function loaded, so dde system:install keeps running against v1. Document restarting the shell (exec $SHELL -l works for zsh and bash). - mkcert's new root CA is only read by Firefox at startup, so a Firefox that was already open keeps showing .test sites as insecure until it is restarted. Signed-off-by: Marc Wieland <marc@whatwedo.ch>
mawiswiss
force-pushed
the
docs/migration-v1-shell-and-browser
branch
from
June 18, 2026 12:41
2d443ed to
d91b45f
Compare
xarem
enabled auto-merge (rebase)
July 17, 2026 18:22
xarem
approved these changes
Jul 17, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Two gaps in the v1 → v2 migration guide that I hit while migrating my own setup. Both make a step look broken even though the migration worked.
1. Reload the shell after removing the v1 integration
dde v1 is loaded as a shell function, so after removing it from
~/.zshrc/~/.bashrcthe current session still resolvesddeto v1. The very next step,dde system:install, then runs against v1 instead of the freshly installed v2 binary. Added a note in step 2 with the reload command for zsh and bash (exec zsh/exec bash).2. Fully restart the browser so the new root CA is trusted
dde system:installinstalls a fresh mkcert root CA, but browsers only read the system trust store at startup. A browser that was already open keeps showing.testsites as insecure, which reads as "the certs are broken". Added a note at the verify step to fully quit and reopen the browser (not just the tab/window).Docs-only change, no code touched.