Repository navigation
Closed
Labels
P2Medium priority / Parity & RefactoringMedium priority / Parity & RefactoringdocumentationImprovements or additions to documentationImprovements or additions to documentation
Milestone
Description
Problem
The current README.md has several critical discrepancies and broken commands in the Installation section:
- Unreachable APT/DNF repository: Lines 125-139 instruct users to install via
https://repo.querya.app/(curl -fsSL https://repo.querya.app/gpg.key ...). The domainrepo.querya.appdoes not exist yet (curl: (6) Could not resolve host: repo.querya.app), because repository deployment (feat(packaging): setup automated APT and DNF repository for Debian/Ubuntu and Fedora #1059) is still pending. Users attempting to install following README get an immediate failure. - Incorrect
.debpackage filename & suboptimal command:- Line 144 mentions
querya-desktop-linux-amd64.deb. The actual release asset generated by CI isQuerya-Desktop-${VERSION}-linux.deb(e.g.Querya-Desktop-0.4.18-linux.deb). - Line 144 uses
sudo dpkg -i ... && sudo apt-get install -f. Recommendingsudo apt install ./Querya-Desktop-*-linux.debis standard and resolves dependencies automatically.
- Line 144 mentions
- Missing
libfuse2requirement for AppImage:- Modern Ubuntu (22.04 / 24.04+) does not ship
libfuse2by default; AppImages fail to launch withoutlibfuse2/libfuse2t64.
- Modern Ubuntu (22.04 / 24.04+) does not ship
- Missing Arch Linux (AUR) and Flatpak documentation:
- Arch Linux package
querya-desktop(yay -S querya-desktop) and local Flatpak bundle install (flatpak install --user ./Querya-Desktop-*-linux.flatpak) are supported in CI but omitted from README.
- Arch Linux package
- macOS Gatekeeper tip:
- Mention
xattr -cr /Applications/Querya.appfor unsigned community builds.
- Mention
Scope
- In
README.md:- Demote/mark
repo.querya.appas "Coming Soon" (reference feat(packaging): setup automated APT and DNF repository for Debian/Ubuntu and Fedora #1059) and promote GitHub Release assets and AUR as the primary installation methods. - Fix
.debfilename pattern and usesudo apt install ./Querya-Desktop-*-linux.deb. - Add AppImage prerequisite for Ubuntu 22.04+ (
libfuse2/libfuse2t64). - Add Arch Linux (AUR:
yay -S querya-desktop) to README. - Add local Flatpak instructions (
flatpak install --user ./Querya-Desktop-*-linux.flatpak). - Add macOS unsigned build bypass note.
- Demote/mark
Acceptance
- Commands in README for Debian/Ubuntu, Fedora, Arch, AppImage, and macOS work without errors when tested against release assets.
- No references to unresolved domains as active installation methods.
Metadata
Metadata
Assignees
Labels
P2Medium priority / Parity & RefactoringMedium priority / Parity & RefactoringdocumentationImprovements or additions to documentationImprovements or additions to documentation
Activity
Jah-yee commentedon Oct 12, 2026
PR #1559 submitted with all 5 categories of fixes: repo.querya.app demoted to Coming Soon (#1059), .deb filename and install command corrected, AppImage libfuse2 prerequisite added, Arch Linux AUR and Flatpak install paths added, macOS Gatekeeper bypass added.
docs(readme): fix Linux install instructions, package filenames, and …
Merge pull request #1656 from QueryaHub/issue/1500-1515-1566-followups
docs(changelog): today's entries; test: calc bar test after #1674 (de…
ZhuchkaTriplesix commentedon Oct 25, 2026
Fixed on dev by 0d22e03: docs(readme): fix Linux install instructions, package filenames, and repo status. It reaches main with the next dev to main merge (closed after checking the code and its tests).