Skip to content

docs(migration): note shell reload and browser restart after v1 upgrade #207

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
xarem merged 3 commits into from
Jul 17, 2026
Merged

docs(migration): note shell reload and browser restart after v1 upgrade #207

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
d91b45f
docs(migration): note shell reload and browser restart after v1 upgrade
mawiswiss Jun 18, 2026
7a02e81
Merge branch 'v2' into docs/migration-v1-shell-and-browser
mawiswiss Jun 25, 2026
80b520a
Merge branch 'v2' into docs/migration-v1-shell-and-browser
xarem Jul 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions docs/guides/migration-from-v1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,8 @@ You can also run both commands in sequence — first `dde system:destroy`, then

### 2. Clean up shell configuration

Remove the dde v1 aliases and autocomplete from your `~/.zshrc` or `~/.bashrc`.
Remove the dde v1 aliases and autocomplete from your `~/.zshrc` or `~/.bashrc` and restart your shell.
If the shell was not restarted, `dde` still resolves to the old v1 commands, even after you have replaced the binary. Running `exec $SHELL -l` will do the trick as well.

### 3. Optionally remove v1 data

Expand Down Expand Up @@ -76,7 +77,7 @@ dde project:up

`project:init` creates the `.dde/` directory, detects your `docker-compose.yml`, and adds Traefik labels. It also strips v1 boilerplate (the explicit `dde` external network, the SSH-Agent volume mount and `SSH_AUTH_SOCK`, legacy `DDE_UID`/`DDE_GID` build args, fixed `container_name`) — in v2, networks and the SSH-Agent socket are injected by the runtime overlay, so the committed compose file stays clean.

Open `https://my-app.test` in your browser to verify.
Open `https://my-app.test` in your browser to verify. Firefox users may need to restart the browser to trust the certificate.

#### .env file migration

Expand Down
Loading