This is the official GenForge NS8 index of modules built for Nethserver 8. Wit All the cool Modules We have curated for you
- GenForge modules index for NS8
- Categories
- 1) Auth & SSO
- 2) Backend as a Service
- 3) Design
- 4) Digital Signature
- 5) ERP & CRM
- 6) Marketing
- 7) File Hosting
- 8) Form Building
- 9) Market SAAS
- 10) Messaging
- 11) No Code Database
- 12) Note Taking
- 13) Passwords
- 14) Project Management
- 15) PAAS(Platform As A Service)
- 16) Scheduling
- 17) Video Conferencing
- 18) Web Analytics
- 19) Workflow Automation
- 20) Database
- 21) Documents And Files
- 22) List manager
- 23) Finance
- 24) HR
- 25) Documentation & Wiki
- 26) Tools
Metadata are built every 6 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.genius.ke/ns8/updates/Alternative URL:
https://raw.githubusercontent.com/geniusdynamics/ns8-genforge/repomd/ns8/updates/
The repomd workflow builds everything and publishes one tree:
| Path | Content |
|---|---|
/index.html, /favicon.svg |
The website, copied from .site/. |
/catalog.json |
Extra data for the website, built by buildsite.py. |
/pipeline.json |
CI state of each module for the Pipeline dialog, built by buildpipeline.py (gh-pages only). |
/ns8/updates/repodata.json |
The repository metadata NethServer reads, built by createrepo.py. |
/ns8/updates/<module>/ |
Logo and screenshots of each module. |
/CNAME, /.nojekyll |
Custom domain and plain file serving for GitHub Pages. |
The same commit is pushed to two branches:
repomd, read throughraw.githubusercontent.comby NethServer and by the NS8 App Index.gh-pages, served by GitHub Pages onhttps://forge.genius.ke/.
So both repository URLs always serve the same files. In the repository settings, GitHub Pages must use Deploy from a branch, branch gh-pages, folder / (root), with forge.genius.ke as custom domain.
What each file does:
createrepo.pyonly writesrepodata.json. It is kept close to the NethForge original.buildsite.pywritescatalog.json: stars, release dates and the quality score of each published module, plus thens8-*repositories of the organization that are not published yet. The website lists those under "In development". The "Alternative to" and upstream links come from the tables of this README.site.jsonholds the settings: organization, custom domain,tools(ns8-*repositories that are not modules) andexclude(repositories to hide)..site/index.htmlis the website. It loadsrepodata.jsonandcatalog.jsonin the browser, and still works whencatalog.jsonis missing.
The Pipeline button in the website header opens a dialog with the CI state of every module:
the release group (from the GitHub releases), the "Publish images" run of the current dev commit,
the "Test dev on QEMU" run that followed it, the latest "Test main on QEMU" run, the open pull
requests to dev and from dev to main, how far dev is ahead of main, and the next step.
It can be filtered by group, by status and by name. The dialog loads pipeline.json only when it
opens; when the file is missing or more than three hours old, it says so.
buildpipeline.pywritespipeline.jsonfrom the GitHub REST API, withGITHUB_TOKEN. It covers everyns8-*repository of the organization with atest-module.yml("Test module") workflow, except thetoolsandexcludelists ofsite.json. It makes about five calls per module and stops before the rate limit runs out; a repository that fails is reported on its row and does not stop the run.- The
pipelineworkflow runs it every hour and right afterrepomd, and commits onlypipeline.jsonon top of the currentgh-pagestree.repomdcopies the existingpipeline.jsonwhen it rebuildsgh-pages, and the two workflows share one concurrency group so they never push at the same time.
GITHUB_TOKEN=$(gh auth token) python3 buildpipeline.py --output /tmp/forge/pipeline.jsonTo preview the website locally, build a copy of the published tree and serve it:
mkdir -p /tmp/forge/ns8/updates && cp -a .site/. /tmp/forge/ && cp -a */ /tmp/forge/ns8/updates/curl -sSo /tmp/forge/ns8/updates/repodata.json https://raw.githubusercontent.com/geniusdynamics/ns8-genforge/repomd/ns8/updates/repodata.jsonpython3 buildsite.py --repodata /tmp/forge/ns8/updates/repodata.json --output /tmp/forge/catalog.jsonpython3 -m http.server -d /tmp/forge 8000pins.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.match: "<Python semver match string>"(or an exacttag),min_from: <semver>— require an installed module version before offering that target as an upgrade. The strictest matching floor wins; stricter image labels are preserved.required: Trueon a pinnedtag— fail generation if the checkpoint image cannot be inspected. Missing or malformed pin configuration also stops publication, preserving the previous published repository.
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 useprepend: Falseto keep natural ordering. - Use
remove: Truefor temporary blacklisting; add comments with issue references for traceability.
GenForge keeps 4.2.0 and 5.0.0 available as mandatory migration checkpoints.
NS8 Software Center and automatic updates use the generated
org.nethserver.min-from labels to select the next eligible version:
| Installed ERPNext module | Next upgrade offered |
|---|---|
Below 4.2.0 |
4.2.0 |
4.2.0 through versions below 5.0.0 |
5.0.0 |
5.0.0 or newer |
The newest eligible release newer than the installed version |
These are NS8 module versions, not ERPNext application versions. New installs
can still use the latest release. Pins retain both checkpoints even as later
releases are published. Targets above 4.2.0 require at least 4.2.0; targets
above 5.0.0 require at least 5.0.0. Pin order alone does not enforce this path:
NS8 sorts versions before applying the minimum-version labels (core 2.10+).
NS8 caches repository metadata for up to an hour. Refresh it before upgrading.
An administrator can clear the configured repository's cache and then reopen
Software Center (replace REPOSITORY_NAME with the configured repository name):
redis-cli DEL cluster/repository_cache/REPOSITORY_NAMEDirect update-module / api-cli commands bypass repository upgrade selection.
Run only checkpoints newer than the installed version and wait for each upgrade
to complete successfully. Replace erpnext1 with the installed instance ID:
# Only when the installed module is below 4.2.0:
update-module ghcr.io/geniusdynamics/erpnext:4.2.0 erpnext1
# After reaching 4.2.0, and only while below 5.0.0:
update-module ghcr.io/geniusdynamics/erpnext:5.0.0 erpnext1Only after reaching 5.0.0 should a later published tag be selected for a manual
CLI update. Do not use a latest-version CLI command to skip the checkpoints.
The NS8 apps catalog shows each app with a quality score out of 9. The score does not judge the software; it measures how complete the listing is, so administrators can choose with confidence. The crawler computes every check from public data and the new score appears after the next crawl.
| Check | Passes when | How to fix it |
|---|---|---|
GitHub topic ns8 |
The code repository has the ns8 topic. |
GitHub: gear icon next to "About", then Topics. |
| Standard categories | categories is not empty and every entry is a Software Center category: collaboration, communication, core, database, development, documentation, monitoring, multimedia, office, security, storage, system_administration, web. |
Replace custom names in metadata.json. |
| Logo | The app has a logo in repodata.json. |
Put a logo.png next to metadata.json. |
| Screenshots | The app has at least one screenshot in repodata.json. |
Put PNG files in a screenshots/ folder next to metadata.json. |
| Description of 60+ characters | description.en is at least 60 characters long. |
Write one or two sentences about what the software does for the user. |
| Translated description | description has a language besides en. |
Add fr, it, de, es, pt, pt_BR, eu or any other. |
| Documentation and bug links | docs.documentation_url and docs.bug_url are both set. |
Fill both in metadata.json. |
| Minimum core label | The image of the version shown has the org.nethserver.min-core label. |
Add --label="org.nethserver.min-core=3.x.y" in build-images.sh and publish a release. |
| License file | GitHub detects a license in the code repository. | Add a LICENSE file with a standard license at the repository root. |
When docs.code_url is missing or points to a repository the crawler cannot read, the topic and license checks fail, and stars and dates stay empty.
{
"name": "dnshelper",
"description": {
"en": "Manage DNS records through DNS provider APIs, for other modules",
"de": "Verwaltet DNS-Einträge über die APIs von DNS-Anbietern, für andere Module",
"es": "Gestiona registros DNS a través de las API de los proveedores DNS, para otros módulos",
"eu": "DNS erregistroak kudeatzen ditu DNS hornitzaileen APIen bidez, beste moduluentzat",
"fr": "Gère les enregistrements DNS via les API des hébergeurs DNS, pour les autres modules",
"it": "Gestisce i record DNS tramite le API dei provider DNS, per altri moduli",
"pt": "Gere registos DNS através das APIs dos fornecedores de DNS, para outros módulos",
"pt_BR": "Gerencia registros DNS por meio das APIs dos provedores de DNS, para outros módulos"
},
"categories": [
"system_administration",
"security"
],
"authors": [
{
"name": "Dan Brown",
"email": "dan@familybrown.org"
}
],
"docs": {
"terms_url": "https://github.com/danb35/ns8-dnshelper/blob/master/TERMS.md",
"documentation_url": "https://github.com/danb35/ns8-dnshelper/blob/master/docs/USER-GUIDE.md",
"bug_url": "https://github.com/danb35/ns8-dnshelper/issues",
"code_url": "https://github.com/danb35/ns8-dnshelper",
"relnotes_url": "https://github.com/danb35/ns8-dnshelper/releases"
},
"source": "ghcr.io/danb35/dnshelper"
}Each module directory also needs a logo.png and a screenshots/ folder, next to its metadata.json.
Under settings, Chose Software Repository
Define the Repo URL as shown below with the Define URL
Then CLick Add
Enabling Testing Repo
For testing Purposes, you may enable the testing Toggle.
Note that Apps installed with Testing Toggle enable may not be suitable for production
All apps are sorted by categories and listed alphabetically. Click on the stars badge to visit the product's GitHub repository. Apps not yet listed but available in the Software Center can be added upon request. Happy searching!
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Auth & SSO | Zitadel | User authentication and session management framework | Okta, Auth0 | NS8link | |
| Auth & SSO | Authentik | User authentication and session management framework | Okta, Auth0 | NS8link | |
| Auth & SSO | 2FAuth | web based self-hosted alternative to One Time Passcode (OTP) generators | Google Authenticator, Microsoft authenticator | NS8link | |
| Auth & SSO | Keycloak | Identity and access management with single sign-on, OpenID Connect and SAML | Okta, Auth0 | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Backend as a Service | PocketBase | Backend server with REST APIs to manage core backend needs | Firebase | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Design | Penpot | Design & prototyping platform | Figma | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Digital Signature | DocuSeal | Digital signing infrastructure | DocuSign | NS8link | |
| Digital Signature | Documenso | Digital signing infrastructure | DocuSign | NS8link | |
| Digital Signature | OpenSign | Document signing platform to prepare, send and sign documents | DocuSign | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| ERP | Dolibarr | Business management suite (ERP and CRM) | Oracle Fusion ERP, Odoo | NS8link | |
| ERP | ERPNext | Agile, modern, module-based business management suite | SAP Business One, Odoo | NS8link | |
| ERP | Frappe Press | Hosting platform to manage Frappe and ERPNext sites, benches and servers | Frappe Cloud | NS8link | |
| CRM | Monica HQ | Open source personal CRM. | NS8link | ||
| CRM | GLPI | The most complete open source service management software | NS8link | ||
| CRM | Espo CRM | web application that allows users to see, enter and evaluate all your company relationships regardless of the type | NS8link | ||
| office | SuiteCRM | Open source CRM for sales, marketing and customer support with workflows and reporting. | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Email Marketing | Keila | Email newsletter tool | Mailchimp, Sendinblue | NS8link | |
| Marketing Automation | Mautic | the World's Largest Open Source Marketing Automation Project | NS8link | ||
| Social Media | Mixpost | Social media management tool to schedule posts, manage accounts and review their statistics | Buffer, Hootsuite | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| File Hosting | Filestash | File manager that lets you manage your data anywhere | Dropbox, Google Drive | NS8link | |
| File Hosting | Spacedrive | Cross-platform file manager, powered by a virtual distributed filesystem (VDFS) written in Rust | Dropbox, Google Drive | NS8link | |
| File Hosting | Chibisafe | File vault with fast chunked uploads, albums and share links | WeTransfer, Imgur | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Form Building | Formbricks | Build forms and manage submission data in one platform | Typeform, Google Forms, React Hook Form | NS8link | |
| Form Building | Formio | Form and data management platform for progressive web applications | Vueform, Typeform | NS8link | |
| Form Building | LimeSurvey | Online survey tool | SurveyMonkey, Typeform | NS8link | |
| Form Building | OpnForm | Form builder to create forms and share them anywhere, without code | Typeform, Google Forms | NS8link | |
| office | KoboToolbox | Build forms and collect field data, including offline collection and data export. | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Marketing SaaS | Dub | Open-source Bitly alternative with built-in analytics | Bitly | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Messaging | Element | Enterprise communication platform | Slack | NS8link | |
| Messaging | Mattermost | Enterprise communication platform for developers | Slack | NS8link | |
| Messaging | Rocket.chat | Enterprise communication platform | Slack | NS8link | |
| Messaging | Zusam | Private forums for groups of friends and family | Facebook Groups | NS8link | |
| Communication | KumoMTA | High-performance mail transfer agent for outbound and inbound delivery, smarthost and relay, managed from NS8. | NS8link | ||
| communication | Mailcow | Mail server suite with SMTP, IMAP, webmail, spam filtering and multi-domain administration. | NS8link | ||
| Communication | parsedmarc | DMARC aggregate, forensic and SMTP TLS report analysis with multi-tenant OpenSearch and Grafana dashboards. | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| No-code Database | NocoDB | No-code database and Airtable alternative | Airtable | NS8link | |
| No-code Database | Seatable | Spreadsheet with database functionalities | Airtable | NS8link | |
| No-code Database | Grist | Relational spreadsheet that combines the flexibility of a spreadsheet with the robustness of a database | Airtable, Google Sheets | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Notetaking | Logseq | Platform for knowledge management, note-taking, and task management | Evernote, OneNote, Roam Research | NS8link | |
| Notetaking | Outline | Wiki and knowledge base | Notion | NS8link | |
| Notetaking | Flatnotes | Note-taking app that stores notes as plain Markdown files, with search and tags | Evernote, Google Keep | NS8link | |
| Notetaking | Colanode | Team workspace for chat, documents and tasks | Slack, Notion | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Password Manager | VaultWarden | Password manager for teams and individuals | 1Password | NS8link | |
| Password | Password Pusher | Securely share sensitive information with automatic expiration & deletion after a set number of views or duration. Track who, what and when with full audit logs. | NS8link | ||
| Password | PasteVault | Encrypted paste service to share text and code snippets with optional expiry | Pastebin | NS8link | |
| Secrets Manager | OpenBao | Secrets manager to store and control access to tokens, passwords, certificates and encryption keys. Open source fork of HashiCorp Vault with Raft storage, PKI, audit log and LDAP/AD login. Release 1.0.1 | HashiCorp Vault, AWS Secrets Manager | NS8link | |
| Secrets Manager | Infisical | Platform to manage application configuration and secrets across your team and infrastructure | HashiCorp Vault, Doppler | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Project Management | Plane | Alternative to Linear, JIRA, Trello, and Height | Linear, JIRA, Trello, Height | NS8link | |
| Project Management | Taiga | Project management software | Asana, Trello, JIRA | NS8link | |
| Project Management | Vikunja | To-do app to organize your next project | Todoist, Trello, Asana | NS8link | |
| Project Management | WeKan | Kanban board for task management | Trello | NS8link | |
| Project Management | Leantime | Project management suite with tasks, timelines, goals and time tracking | Asana, Monday | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| PaaS | Coolify | Self-hostable Heroku alternative | Heroku | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Scheduling | Cal.com | Scheduling infrastructure, alternative to Calendly | Calendly | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Video Conferencing | Jitsi | Video conferences platform and SDK | Zoom | NS8link | |
| Video Conferencing | LiveKit | SFU and SDKs for high-performance, scalable WebRTC | Twilio, Agora | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Web Analytics | Matomo | Google Analytics alternative | Google Analytics | NS8link | |
| Web Analytics | Plausible | Google Analytics alternative | Google Analytics | NS8link | |
| Web Analytics | Swetrix | Google Analytics alternative | Google Analytics | NS8link | |
| Web Analytics | Umami | Google Analytics alternative | Google Analytics | NS8link | |
| Business Intelligence | Metabase | Analytics and dashboards to let your company explore data on their own | Tableau, Power BI | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Workflow Automation | Activepieces | No-code business automation tool | Zapier, Tray | NS8link | |
| Workflow Automation | N8N | Node-based workflow automation tool for developers | Zapier | NS8link | |
| Workflow Automation | Windmill | Platform to build internal tools, workflows and scripts in Python, TypeScript, Go and other languages | Retool, Zapier | NS8link | |
| Workflow Automation | Pipedream | Workflow automation and API integration platform | Zapier, Integromat | NS8link | |
| Workflow Automation | Temporal | Workflows as code platform | Airflow, AWS Step Functions | NS8link | |
| Workflow Automation | Semaphore UI | Effortlessly manage the tasks with a modern, intuitive interface built for DevOps teams. | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Database | SurrealDB | Database | PostgresDB, MariaDB | NS8link | |
| Database | CouchDB | Database | PostgresDB, MariaDB | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Documents & Files | Striling PDF | Your locally hosted one-stop-shop for all your PDF needs. | Adobe Acrobat Reader | NS8link | |
| Books | Calibre | Calibre is a powerful and easy to use e-book manager. | NS8link | ||
| Books | Calibre-web | Web app for browsing, reading and downloading eBooks stored in a Calibre database | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| List Manager | List Monk | Self-hosted newsletter and mailing list manager | Keila | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Finance | Fireflyiii | A free and open source personal finance manager | NS8link | ||
| Finance | Wallos | Open-Source Personal Subscription Tracker | NS8link | ||
| Finance | Maybe | Maybe is a open-source OS for your personal finances Chart built by a small team Maybe Team alongside an incredible community | NS8link | ||
| Finance | SolidInvoice | Invoicing application to manage clients, quotes, invoices and payments | FreshBooks, QuickBooks | NS8link | |
| Finance | Bigcapital | Online accounting software, built to automate business financial processes | QuickBooks, Xero | NS8link | |
| Finance | Invoice Ninja | Invoicing platform to create quotes and invoices, track expenses and accept payments | FreshBooks, QuickBooks | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| HR | Chief On Boarding | ChiefOnboarding is a free and open source employee onboarding platform. | MintHCM | NS8link | |
| HR | MintHCM | Human capital management system for employees, recruitment, leave and company records | BambooHR, Workday | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Documentation | Docmost | Open-source collaborative wiki and documentation software | Notion Confluence | NS8link | |
| Documentation | Bookstack | A platform for storing and organising information and documentation. | NS8link |
| Category | Company | Description | GitHub Stars | Alternative to | NS8link |
|---|---|---|---|---|---|
| Security | SOCFortress CoPilot | Unified security operations with connectors for Wazuh, Graylog, Velociraptor and other SOC tools. | NS8link | ||
| Tools | IT Tools | Useful tools for developer and people working in IT | NS8link | ||
| monitoring | Tactical RMM | Remote monitoring and management with remote access, automated checks and patch management. | NS8link | ||
| Tools | Gitea | Private, Fast, Reliable DevOps Platform | Github Gitlab | NS8link | |
| Tools | Coder | Cloud development environments, created from templates and reached from the browser or your IDE | GitHub Codespaces, Gitpod | NS8link | |
| Bookmarks | Linkwarden | Self-hosted collaborative bookmark manager to collect, organize, and preserve webpages, articles, and more... | NS8link | ||
| Tools | NTFY | Send push notifications to your phone or desktop using PUT/POST | NS8link | ||
| Tools | Homarr | A simple, yet powerful dashboard for your server. | NS8link | ||
| Tools | Xibo | Digital signage platform to schedule and publish content to screens from a web CMS | ScreenCloud, Yodeck | NS8link | |
| Tools | Dashy | Start page that gathers links and status checks for your services in one dashboard | Heimdall | NS8link | |
| Tools | Warpgate | Smart SSH, HTTPS and MySQL bastion that requires no client-side software, with a web admin interface | Teleport, Apache Guacamole | NS8link | |
| Tools | LinkStack | Link page to publish all your links, social profiles and contacts in one place | Linktree | NS8link | |
| Tools | Kutt | URL shortener with custom domains, statistics, password protection and an API | Bitly, TinyURL | NS8link | |
| system_administration | NetBox | Network source of truth with IP address management, racks, devices and circuits. | NS8link |
The website compares the container tags in the selected NS8 release's
org.nethserver.images label with public Docker Hub and GHCR tags. The card shows
its primary application; app details show registry links, packaged and newest
matching tags, the check time, and supporting containers. GitHub's latest stable
project release is shown separately when a README upstream repository is available.
Updates are subject to review and testing.
These checks add optional upstream_check data to catalog.json and never change
repodata.json, installation commands or image pins. They refresh with the
existing publishing schedule. Older or missing catalogs continue to work, and
checks for a different NS8 module release are ignored by the page.
upstream.json maps ambiguous app names to a primary image using its full registry
and repository, without a tag. Otherwise a unique repository basename matching
the module ID is used. Custom-built images may use module version numbers rather
than application versions: for these, set github and an explicit versions
mapping from released NS8 module tag to packaged upstream application version.
A new module release requires its own mapping; no old mapping is carried forward.
For example, SuiteCRM module 1.0.0 packages application 8.10.2.
Comparison is conservative: numeric versions are ordered numerically, prereleases and moving tags are not compared, and image prefixes/variants must match exactly. NetBox’s documented composite application/container version suffix is compared numerically.
Updates are split by major version. A newer tag with the same major version
(for example Postgres 15.20 → 15.21) is an update. A newer major version
(Postgres 15 → 18) is reported separately as a major upgrade, because it can
change data formats or configuration and needs a migration plan. Each image shows
both its newest matching tag and, when there is one, its next major version. The
app's own status comes from its primary image only; databases, caches and other
supporting containers are counted apart as dependency updates and major dependency
upgrades. The website can filter by updates, major upgrades or dependency updates.
Pinned digests are displayed, but digest-only rebuilds are not checked. Unknown
version schemes, unsupported/private registries, missing tags, rate limits and
incomplete scans appear as unverified, rather than current. A newer matching tag
found during a partial scan can still flag an update; it is labelled as the newest
found rather than guaranteed latest. Registry queries are deduplicated, have timeouts,
and run only during the build.
Tags are read from each registry's tags/list API, which returns every tag (up to
10,000 per page on Docker Hub and 1,000 on GHCR, up to 20 pages), so the packaged tag is found when it exists. Listing
tags is not an image pull and does not count against Docker Hub pull limits.
Docker Hub requests use the organisation secrets DOCKER_HUB_USERNAME and
DOCKER_HUB_ACCESS_TOKEN when they are set, and run anonymously otherwise. The
credentials are only sent to Docker's token service, never to the registry or into
catalog.json. lscr.io images are read from the same LinuxServer images on GHCR.
Run without external upstream calls with python3 buildsite.py --skip-upstream.
--org-repos also disables all upstream network checks for offline builds. Run
comparison and failure-handling tests with python3 -m unittest discover -s .tests.
The optional browser regression check is node .tests/test_site.cjs (requires
Playwright and Chromium; set CHROMIUM_PATH if Chromium is installed elsewhere).

