Skip to content

Commit

Permalink
Add .ddev/.downloads to mutagen exclusions, fixes ddev#4645 (ddev#4646)
Browse files Browse the repository at this point in the history
  • Loading branch information
rfay authored Feb 14, 2023
1 parent 2b9dfeb commit 8fe3327
Show file tree
Hide file tree
Showing 2 changed files with 3 additions and 1 deletion.
3 changes: 2 additions & 1 deletion docs/content/users/install/performance.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Mutagen can offer a big performance boost on macOS and Windows. It’s fast and
### Enabling and Disabling Mutagen

!!!warning "Don’t Install Mutagen"
Don’t install the `mutagen` binary separately. If it’s not available, DDEV will install and upgrade it for you.
You do not need to install anything to use mutagen. DDEV installs and maintains its own `mutagen` binary.

We recommend enabling Mutagen globally with `ddev config global --mutagen-enabled`. You can disable it again with `ddev mutagen reset && ddev config global --mutagen-enabled=false`.

Expand Down Expand Up @@ -137,6 +137,7 @@ Mutagen can offer a big performance boost on macOS and Windows. It’s fast and

### Troubleshooting Mutagen Sync Issues

* Does `ddev start` take forever, with perhaps many minutes of "dots"? Take care that you don't have big binaries that mutagen is trying to sync, which will cause endless "dots" as your project is starting. There is already an exclusion place for database tarballs and the like, the `.tarballs` directory; if you put dumps there they will be ignored by mutagen. To find out what mutagen is trying to sync, use `ddev mutagen status -l` in another window.
* Please make sure that DDEV projects work *without* Mutagen before troubleshooting it. Run `ddev config --mutagen-enabled=false && ddev restart`.
* Rename your project’s `.ddev/mutagen/mutagen.yml` file to `.ddev/mutagen/mutagen.yml.bak` and run `ddev restart`. This ensures you’ll have a fresh version in case the file has been changed and `#ddev-generated` removed.
* `export DDEV_DEBUG=true` will provide more information about what’s going on with Mutagen.
Expand Down
1 change: 1 addition & 0 deletions pkg/ddevapp/mutagen_config_assets/mutagen.yml
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ sync:
- "/.tarballs"
- "/.ddev/db_snapshots"
- "/.ddev/.importdb*"
- "/.ddev/.downloads"
- ".DS_Store"
- ".idea"
{{ if .UploadDir }}
Expand Down

0 comments on commit 8fe3327

Please sign in to comment.