Files
ProxMenux/oci/VALIDATION.md
T
MacRimi fc41b04e87 Pre-release 1.2.7: OCI fixes, 12 new catalog applications and docs updates
Last changes before version 1.2.7.

OCI manager Apps
- Multi-container applications start while one of their containers is
  being backed up: the start hook waits until vzdump releases it and does
  not start it twice. The DHCP client of a dependency no longer keeps the
  lock of the hook, so later starts do not hang, and the watchdog waits
  while a dependency is locked. Installing or updating ProxMenux replaces
  the published copies of the hook already in place.
- Images built from scratch with a numeric user, such as ddns-updater,
  install: the container is created from a copy of the image that adds
  the /etc/passwd and /etc/group Proxmox VE needs, and the application
  runs with the user the image declares. The downloaded image stays
  unchanged. An image with a named user and no user database stops
  before anything is created, with a message that says why.

Catalog
- Twelve new applications: MDBListarr, CrossWatch, Free Games Claimer
  Remaster, Cloudreve, Poznote and AceStream HTTP Proxy, suggested in
  discussion #440, and the Dockur images of Chrony, Dnsmasq, Tor,
  Stunnel, strfry and Statping. The catalog lists 347 applications.
- Their prompts, labels and notes are translated into the seven
  languages of the menus.

Documentation
- OCI manager: architecture, lifecycle and stacks pages revised, with
  larger diagrams and new screenshots.
- Contributors: the page now thanks those developing, reviewing,
  translating and testing ProxMenux today and those who helped in its
  first steps, with new avatars.

Tests for the stack start hook, the watchdog, the user database check
of OCI images and the Tor installation summary.
2026-10-25 13:17:54 +01:00

4.0 KiB

OCI application validation

43 of 347 applications in the OCI catalog have been tested for real: 41 in the ProxMenux lab and 2 by the community. The OCI installer shows them as verified, with a ✓ in the lists.

Each test describes the scenario that was run and names the image it ran on. It does not cover every possible configuration of the application, and a newer image has not been tested until someone reports it.

Taking part

Any application that is not listed here is open for testing.

  1. Check the ProxMenux Roadmap to see which applications someone is already testing. With access to the board, create a card for the application and move it to In progress while you test it.
  2. Test the application with the OCI manager and fill in the OCI validation report. The report records the image and the exact scenario: install mode, storage, network and GPU.
  3. A reviewer reads the report and comments /validated on it. The application is then added to this list with your GitHub user and shown as verified in the OCI installer, and the report is closed.

Reviewers are listed in .github/oci-validation-reviewers, and a reviewer does not validate their own report. A validation can also be added with a pull request that adds the entry to oci/catalog/verification.json and regenerates this file with python3 .github/scripts/oci_validation.py render; CI checks that the entry credits the author of the pull request.

An application that cannot be validated for a reason outside the tester's hands — hardware nobody has, something only Docker provides, a fix still pending in ProxMenux — moves to Blocked on the board, with a line saying why and what would make it worth trying again.

Questions and ideas about OCI testing go in discussion #440.

Tested by the community

Application Tested by Date Image Scenario Report
Glances @Vaso73 2026-09-27 — — Report
PocketBase @Vaso73 2026-09-27 — — Report

Tested in the ProxMenux lab

Application Category
2FAuth Authentication & Security
AdGuard Home Adblock & DNS
Adguardhome Sync Adblock & DNS
Alby Hub ✨ Finance & Budgeting
Alist Files & Sharing
aMule Files & Downloads
Chromium Browsers & Web Desktops
CodeProject.AI Server AI
CopyParty Files & Sharing
Crafty Gaming & Leisure
Ddclient Adblock & DNS
Duplicati Backup & Recovery
Etherpad Documents & Notes
FileBrowser Quantum Files & Sharing
FlareSolverr *Arr Suite
Flexget *Arr Suite
Frigate NVR & Cameras
Grafana Monitoring & Analytics
Immich Media
JDownloader Files & Downloads
Jenkins CI/CD AI / Coding & Dev-Tools
Linkwarden Documents & Notes
Memos Documents & Notes
MineOS Gaming & Leisure
Motioneye NVR & Cameras
Nextcloud Productivity & Workflows
Nextcloud Stack Productivity & Workflows
OpenList Files & Sharing
Openssh Server Remote Access & VPN
Paperless-ngx Productivity & Workflows
Phpmyadmin Databases
Qbittorrent Files & Downloads
Rclone WebUI Backup & Recovery
Real-Debrid Torrent Client Files & Downloads
ShareCoveX Files & Sharing
SnapOtter Media & Streaming
Tandoor Recipes Productivity & Workflows
Thelounge Communication & Community
Trilium Documents & Notes
Wireguard Remote Access & VPN
WireGuard Easy Remote Access & VPN