Common known issues and questions

[HUMORCE]

Common known issues

• MSI decompression/extraction error

This is usually caused by a msiexec process exception, go one of them:

1. Restart the PC then retry

2. Switch to alternative MSI extractor: scoop config use_lessmsi true (Default: false)

3. Resolve the msiexec exception/occupation then retry, if you know about it

Learn more: https://learn.microsoft.com/en-us/windows/win32/msi/error-codes

• 7z decompression/extraction error

Make sure you have the latest version of 7zip installed: scoop update 7zip, if you have enabled use_external_7zip, updating it by you can do

• Inno package decompression/extraction error

Make sure you have the latest version of innounp installed: scoop update innounp Currently, just install main/innounp, versions/innounp-unicode will removed on future

• Download via aria2 failed

Disable aria2 then retry: scoop config aria2-enabled false

Usually caused by remote server refuses multi-threaded downloads or other factors that we don't know. We should NOT create an issue for cases where it just cannot download via aria2 when learned about this

• Hash check failed for nightly manifests (Versions bucket, mainly)

Some manifests may be updated before or after Excavator action is performed, especially manifests that are updated frequently. e.g. versions/ffmpeg-nightly, versions/vscode-insiders

• Failed to update Scoop Core or Buckets caused by damaged/conflicted git repo

Core

cd <scoop>\apps\scoop
rm current -force -recurse
git clone https://github.com/ScoopInstaller/Scoop.git current

Bucket

scoop bucket rm <bucket>
scoop bucket add <bucket>
# For 3rd-party buckets:
scoop bucket add <bucket> <URI>

• Symbolic link / Developer Mode related (decompression or mandatory requirement by app)

Some pakcages requires symlinks creatation for decompression, e.g. main/krew, main/twilio-cli

Enable Developer Mode to gain the ability to create symbolic links without admin privileges / UAC prompt, the option available in Windows 10/11 only.

Alternative, you can execute install/update commands with admin privileges, helpful tools: main/gsudo, main/sudo, or sudo for Windows(available in Windows 11, version 24H2)

There are some system settings that Scoop recommend: scoop checkup

• Limitation of manifest generate feature and Versions bucket

When a version specified for manifest <app>@<version>, Scoop generate manifest based on Version variables, if manifest using Captured variables, it will NOT work properly.

You should first consider installing specific version of app from the Versions bucket, it provides older, variants, dev, nightly, etc. version of applications, e.g. versions/python27, versions/python310, versions/ruby27, versions/ffmpeg-nightly, versions/zig-dev

Learn more: https://github.com/ScoopInstaller/Scoop/wiki/Switching-Ruby,-Python-and-PHP-Versions

Related: #3894

• Limitation of browsers

Chromium based:

1. DRM protected content cannot works
2. Profile might point to default location (e.g. $env:LOCALAPPDATA\Google\Chrome\User Data), when --user-data-dir point to a specified path(e.g. $dir\userdata(persist\googlechrome\userdata)).

Firefox based: ScoopInstaller/Extras#8779 (comment)

Both of them don't fit perfectly with Scoop Persistence.

Personally, I would recommend that you install the default/main browser by its official installer.

• VCRedist / .NET Runtime related

When they are suggested by manifest, it means that the app requires them. You can install them any way you want, not limited to Scoop

• Search performance related

scoop config use_sqlite_cache true or 3rd-party tools, e.g. extras/sfsu

• Virus reports of Scoop Core / Shims

Scoop is distributed to end users as source code, except for the following pre-compiled binaries:

File:        supporting/shims/71/shim.exe
Source Code: https://github.com/71/scoop-better-shimexe
-------------------------------------------------------------------------------
File:        supporting/shims/kiennq/shim.exe
Source Code: https://github.com/kiennq/scoop-better-shimexe
-------------------------------------------------------------------------------
File:        supporting/shims/scoopcs/shim.exe
Source Code: https://github.com/ScoopInstaller/Shim
-------------------------------------------------------------------------------
File:        supporting/shims/validator/bin/Newtonsoft.Json.Schema.dll
             supporting/shims/validator/bin/Newtonsoft.Json.dll
             supporting/shims/validator/bin/Scoop.Validator.dll
             supporting/shims/validator/bin/validator.exe
Source Code: https://github.com/ScoopInstaller/Scoop/tree/master/supporting/validator

For individual users, review the code on your own.

For employees, contact with IT Security Manager, Information Security Manager, Network Security Manager, or other relevant staff.

Common questions

• Revert from fork to Scoop Core

  How can I go back to original REPO https://github.com/lukesampson/scoop #4495 (comment)

• Migration from other devices/locations:

  TODO

• Virus reports of apps

In most cases, the download URLs in the manifest is the original/official link. If you get a report for app that downloaded from Scoop, you will get the same report for download it from its original distribution page. And certain packages it is expected to report as viruses, e.g. mining programs, anti-rootkit , penetration test tools, etc.

For example, Golang and the programs it builds: https://go.dev/doc/faq#virus