This is the official NethForge NS8 index of modules.
Metadata are built every 4 hours at 00:25, 06:25 ,12:25, 18:25 UTC and on each commit to the main branch.
If you want to add a module to this repository, just follow the
instructions
for ns8-repomd, finally open the pull request here!
To use the modules listed here as NS8 repository, see the manual page and set the following URL:
https://forge.nethserver.org/ns8/updates/
pins.yml lets you control image visibility and ordering for modules to support staged upgrades and hide broken tags. Each module key contains a list of pin rules:
tag: <semver>,prepend: <True|False>— ensure a specific tag is listed; prepend True puts it at the top, False appends it.match: "<Python semver match string>",remove: True— hide matching tags from clients. E.g.<2.0.0.
Use cases:
-
Maintain upgrade path across breaking releases (e.g., Nextcloud NC27→NC28):
nextcloud: - { tag: 1.2.1, prepend: False }
-
Keep a known-good baseline visible for older cores:
core: - { tag: 2.9.6, prepend: True }
-
Hide buggy module versions:
mail: - { match: "1.7.0", remove: True } - { match: "1.7.1", remove: True }
Editing workflow:
- Edit
pins.ymland commit tomainbranch; metadata will rebuild automatically on schedule and on push. - Prefer
prepend: Trueonly for critical baseline tags; otherwise use prepend: False to keep natural ordering. - Use
remove: Truefor temporary blacklisting; add comments with issue references for traceability.