Skip to content

feat: added troubleshooting advice for windows SCA issue #302

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
merged 1 commit into from
Oct 21, 2025
Merged

feat: added troubleshooting advice for windows SCA issue #302

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
3 changes: 3 additions & 0 deletions pages/modernization-assessment.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -100,6 +100,9 @@ You can learn more about the modernization potential of your applications by ana

Tidal Code Analysis is performed using our command-line software utility Tidal Tools. The software is available to download [here](https://get.tidal.sh/), and you can learn more about getting started with the tool in our guide [here](https://guides.tidal.cloud/tidal-tools.html).

{: .note }
Tidal Source Code Analysis uses Docker under the hood. There is a [known issue](/troubleshooting.html#windows-source-code-analysis) with Docker where scanning a codebase hosted on a Windows file system will be very time consuming. If you are on Windows, we recommend hosting the sourse code which you will analyze on [WSL](https://learn.microsoft.com/en-us/windows/wsl/about).

Once you have Tidal Tools installed, run the following command and follow the prompts to authenticate with Accelerator.

`tidal login`
Expand Down
8 changes: 8 additions & 0 deletions pages/troubleshooting/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -202,6 +202,14 @@ must escape the backslash character with another backslash (which is the escape
character), so the string must be as the following: `C:\\Program Files\\Tidal
Software\\tidal`.

### Source Code Analysis is slow when the source code is stored on Windows {#windows-source-code-analysis}

When running Tidal Source Code Analysis on codebases that are stored in a Windows filesystem, you might notice that the process is quite slow - especially on larger codebases.

The root cause of this issue is that since Source Code Analysis is running in a Linux container, accessing the Windows file system from within this container is very time-consuming.

For analyzing larger codebases on Windows, we recommend using [WSL](https://learn.microsoft.com/en-us/windows/wsl/about), and hosting the source code inside your WSL environment.

## Linux troubleshooting {#linux}

### Manage Docker as a non-root user {#docker-non-root}
Expand Down