From 66eb22e5fae76f2710d25b28ab257780f9417edb Mon Sep 17 00:00:00 2001 From: Monica Chao Date: Mon, 6 Jan 2025 10:28:57 -0600 Subject: [PATCH] docs: added section on symlinks when using SFS (#21712) ## Description Based on customer feedback, it was not clear how to resolve the `unable to create symbolic link` error which can result from a user without permissions to create symbolic links when using a synchronized file share. ## Related issues or tickets - SEG-689 ## Reviews - [ ] Technical review - [X] Editorial review - [ ] Product review --------- Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/desktop/features/synchronized-file-sharing.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/manuals/desktop/features/synchronized-file-sharing.md b/content/manuals/desktop/features/synchronized-file-sharing.md index 789a9c159f9..91a98a39c62 100644 --- a/content/manuals/desktop/features/synchronized-file-sharing.md +++ b/content/manuals/desktop/features/synchronized-file-sharing.md @@ -94,6 +94,8 @@ In general, use your `.syncignore` file to exclude items that aren't critical to - POSIX-style Windows paths are not supported. Avoid setting the [`COMPOSE_CONVERT_WINDOWS_PATHS`](/manuals/compose/how-tos/environment-variables/envvars.md#compose_convert_windows_paths) environment variable in Docker Compose. +- If you don't have the correct permissions to create symbolic links and your container attempts to create symbolic links in your file share instance, an **unable to create symbolic link** error message displays. For Windows users, see Microsoft's [Create symbolic links documentation](https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-10/security/threat-protection/security-policy-settings/create-symbolic-links) for best practices and location of the **Create symbolic links** security policy setting. For Mac and Linux users, check that you have write permissions on the folder. + ## Feedback and support To give feedback or report bugs, visit: