Skip to content

Commit 7822a1d

Browse files
authored
Merge pull request #2147 from ivan-hc/dev
Add checksum troubleshooting in docs
2 parents 47b41e5 + 7f3e581 commit 7822a1d

File tree

2 files changed

+25
-0
lines changed

2 files changed

+25
-0
lines changed

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1067,6 +1067,7 @@ Below you can access documentation pages for common issues and frequently asked
10671067
- [An application does not work, is old and unsupported](docs/troubleshooting.md#an-application-does-not-work-is-old-and-unsupported)
10681068
- [Cannot download or update an application](docs/troubleshooting.md#cannot-download-or-update-an-application)
10691069
- [Cannot mount and run AppImages](docs/troubleshooting.md#cannot-mount-and-run-appimages)
1070+
- [Checksum cannot be verified, does not match or not yet supported](docs/troubleshooting.md#checksum-cannot-be-verified-does-not-match-or-not-yet-supported)
10701071
- [Failed to open squashfs image](docs/troubleshooting.md#failed-to-open-squashfs-image)
10711072
- [Spyware, malware and dangerous software](docs/troubleshooting.md#spyware-malware-and-dangerous-software)
10721073
- [Stop AppImage prompt to create its own launcher, desktop integration and doubled launchers](docs/troubleshooting.md#stop-appimage-prompt-to-create-its-own-launcher-desktop-integration-and-doubled-launchers)

docs/troubleshooting.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
- [An application does not work, is old and unsupported](#an-application-does-not-work-is-old-and-unsupported)
44
- [Cannot download or update an application](#cannot-download-or-update-an-application)
55
- [Cannot mount and run AppImages](#cannot-mount-and-run-appimages)
6+
- [Checksum cannot be verified, does not match or not yet supported](#checksum-cannot-be-verified-does-not-match-or-not-yet-supported)
67
- [Failed to open squashfs image](#failed-to-open-squashfs-image)
78
- [Spyware, malware and dangerous software](#spyware-malware-and-dangerous-software)
89
- [Stop AppImage prompt to create its own launcher, desktop integration and doubled launchers](#stop-appimage-prompt-to-create-its-own-launcher-desktop-integration-and-doubled-launchers)
@@ -59,6 +60,29 @@ However, I suggest contacting the upstream developers to convince them to upgrad
5960
| [Back to "Troubleshooting"](#troubleshooting) | [Back to "Main Index"](../README.md#main-index) |
6061
| - | - |
6162

63+
------------------------------------------------------------------------
64+
### Checksum cannot be verified, does not match or not yet supported
65+
Starting with version [9.9.5](https://github.com/ivan-hc/AM/releases/tag/9.9.5), a checksum has been introduced for installed apps. Its status is verified when installing or updating apps.
66+
67+
This is a system for verifying the validity of installed programs and is primarily based on data provided by a .zsync file (especially in AppImages) or DIGEST (for hashes) published online alongside the app, on its host.
68+
69+
A lack of validity during verification DOES NOT DIRECTLY SIGNAL THAT THE DOWNLOADED APPS ARE INVALID, but rather a warning to users of that app to urge upstream to adopt current security standards.
70+
71+
It is therefore simply a way to try to regularize portable apps and AppImages for security purposes, as is already done in other package managers.
72+
73+
"AM" does not store packages in its own database, but retrieves them from the original source via installation scripts. The apps you install are updated in real time by upstream or by the owner of the package pointed to by the installation script. Therefore, **"AM" is not responsible for malfunctions of individual installed apps**.
74+
75+
Given the "uncontrollable" nature of portable programs, **it was necessary to implement this feature in "AM" to at least provide greater awareness to its users**.
76+
77+
**Whether upstream decides to apply these security standards or not, is another matter**. And you, the user, could help by reporting the issue to them.
78+
79+
However, if you trust the author of that app and are only interested in using it, you can ignore the message.
80+
81+
------------------------------------------------------------------------
82+
83+
| [Back to "Troubleshooting"](#troubleshooting) | [Back to "Main Index"](../README.md#main-index) |
84+
| - | - |
85+
6286
------------------------------------------------------------------------
6387
### Failed to open squashfs image
6488
When installing a script for an AppImage, you may see an error like this

0 commit comments

Comments
 (0)