Add a kiwix installer.

[tewalds]

Scripts which are clearly AI generated and not further revised by the Author of this PR (in terms of Coding Standards and Script Layout) may be closed without review.

✍️ Description

Add a kiwix installer. Kiwix serves offline content, for example wikipedia.

https://kiwix.org/
https://github.com/kiwix/kiwix-tools

🔗 Related PR / Issue

Fixes #1855

✅ Prerequisites (X in brackets)

• Self-review completed – Code follows project standards.
• Tested thoroughly – Changes work as expected.
• No breaking changes – Existing functionality remains intact.
• No security risks – No hardcoded secrets, unnecessary privilege escalations, or permission issues.

---

🛠️ Type of Change (X in brackets)

• 🐞 Bug fix – Resolves an issue without breaking functionality.
• ✨ New feature – Adds new, non-breaking functionality.
• 💥 Breaking change – Alters existing functionality in a way that may require updates.
• 🆕 New script – A fully functional and tested script or script set.
• 🌍 Website update – Changes to website-related JSON files or metadata.
• 🔧 Refactoring / Code Cleanup – Improves readability or maintainability without changing functionality.
• 📝 Documentation update – Changes to README, AppName.md, CONTRIBUTING.md, or other docs.

---

🔍 Code & Security Review (X in brackets)

• Follows Code_Audit.md & CONTRIBUTING.md guidelines
• Uses correct script structure (AppName.sh, AppName-install.sh, AppName.json)
• No hardcoded credentials

📋 Additional Information (optional)

---

📦 Application Requirements (for new scripts)

Required for 🆕 New script submissions.
Pull requests that do not meet these requirements may be closed without review.

• The application is at least 6 months old
• The application is actively maintained
• The application has 600+ GitHub stars
• Official release tarballs are published
• I understand that not all scripts will be accepted due to various reasons and criteria by the community-scripts ORG

[greptile-apps]

Greptile Overview

Greptile Summary

This PR adds a new Kiwix LXC installer by introducing a CT build script (ct/kiwix.sh), an in-container install script (install/kiwix-install.sh), and the frontend metadata entry (frontend/public/json/kiwix.json). The CT script provisions a Debian 13 container and then attempts to prompt for and configure a host bind-mount for ZIM archives; the install script downloads the Kiwix Tools tarball and creates a kiwix-serve systemd unit on port 8080.

However, several changes currently conflict with repo conventions/policies (JSON schema + icon URL requirements, apt/apt-get policy, service enable convention, comment restrictions in scripts) and there is a functional issue where the service fails to start on a fresh install if no /data/*.zim files exist yet. These issues should be resolved before merge to keep consistency with the existing script ecosystem and avoid broken first-run behavior.

Confidence Score: 2/5

• Not safe to merge as-is due to policy violations and a first-run service failure scenario.
• Multiple repo-enforced conventions are violated (JSON schema/logo rules, apt vs apt-get, service enable flow, comment restrictions, ct success footer), and the created systemd unit will fail/restart when no ZIM files exist yet, which is a common first-run state for Kiwix.
• ct/kiwix.sh, install/kiwix-install.sh, frontend/public/json/kiwix.json

Important Files Changed

Filename	Overview
ct/kiwix.sh	Adds new Kiwix CT creation script, but violates repo standards (extra comments, nonstandard completion block) and includes an interactive host prompt/bind-mount logic that can break automation.
install/kiwix-install.sh	Adds Kiwix install script, but violates required conventions (uses apt-get, uses daemon-reload, reinstalls likely-preinstalled deps, and service ExecStart will fail if no /data/*.zim exists).
frontend/public/json/kiwix.json	Adds Kiwix metadata JSON, but missing required schema fields and uses a non-selfh.st logo URL (violates JSON requirements).

[greptile-apps]

_{3 files reviewed, 9 comments}

_{Edit Code Review Agent Settings | Greptile}

[michelroegl-brunner]

This needs to be further discused. As there has been two releases In Dezember, the last release before that was over 1.5 Years ago. So i vote for waiting a bit longer if the app gets a more stable update schedule, then we can think ybout adding it. @community-scripts/contributor

[tewalds]

How is that relevant? It's a server for offline content with a stable data format and has ~800 stars on github. The content (eg archive of wikipedia) is updated fairly regularly, but the server doesn't need to be. Still, it's good to have a nice proxmox installer for those who want to serve the content. If there is a similarly trivial way to create a LXC, mount a directory readonly, install it from apt and set up a service, then maybe the correct answer is to point people at that instead, but I don't know of such a trivial way and apt is out of date.

[CrazyWolf13]

I have nothing against it, there are commits, the app has two new releases and sometimes an app just reaches a somewhat polished app (though there is always room for more, which is not always neccessary)

We have apps in our catalogue with far far less updates and unstable release shedules.

I see no reason to not accept such a contribution.

[CrazyWolf13]

not needed at all

[CrazyWolf13]

there is $LOCAL_IP made available by our core funcs

[CrazyWolf13]

was this even tested?

pct will not work when executing the update, as it runs from within the LXC

[CrazyWolf13]

Please stick to our default ending.

[github-actions]

@tewalds This PR has been marked as stale. It will be closed if no new commits are added in 7 days.

[tewalds]

My server is down for the next week or two as I move house, but will come back to this when I have a working server again.

[github-actions]

@tewalds Closing stale PR due to inactivity (no commits for 7 days after stale label).

[CrazyWolf13]

@tewalds Feel free to reopen once you have time again.