Suggest an application for the OCI catalog

[MacRimi]

Title: Suggest an application for the OCI catalog

Hi everyone,

OCI manager Apps installs applications from their official container images as native Proxmox LXC containers, without Docker. It arrived with the 1.2.6.2 beta and a catalog of 334 applications, and I'd like it to grow with the ones you actually use.

This thread is the place for that. There are four ways to take part, from the quickest to the most involved.

1. Suggest an application

If you use a Docker image that is not in the catalog, leave a comment with:

Application:
Image (for example lscr.io/linuxserver/sonarr or ghcr.io/owner/app):
Where it is published (GitHub, Docker Hub or another registry, with the link):
Category you would expect to find it in:
Compose file or docker run line you use (a link is fine):
Anything it needs (a database, a GPU, a USB device…):

2. Try it yourself

You don't have to wait for the catalog. In OCI manager Apps, choose Install an image that is not in the catalog and paste its Compose file, a docker run line or just the image reference. ProxMenux shows what it understood and what it could not translate before creating anything.

If it works, tell us here what you pasted and whether you had to change something.

3. Write its oci-compose

Some applications need more than a Compose file can say: a question with its own text, a password generated during the installation, a GPU profile, a check of the first start. That is written in an oci-compose, the file ProxMenux installs an application from.

You write only what you decide (the image, its ports, variables and volumes) and ProxMenux completes the rest. The same menu option reads the file, tells you which field is wrong if there is an error, and installs it as you wrote it, so you can test and adjust.

The format is explained block by block in the README of the OCI engine, with two complete examples: Jellyfin with GPU and Duplicati with generated passwords. Attach the file that worked for you and I'll add the application from it.

4. Validate an application of the catalog

Applications tested for real show a ✓ in the installer, with the name of who tested them. The list and the steps are in oci/VALIDATION.md.

A test is simple: install the application, check that it does what it should, restart it, update it and remove it, and say which image and which options you used. For now, post the result as a comment here. With version 1.2.7 there will be a form that records it by itself once a reviewer confirms it.

A report that something does not work is just as useful as one that it does.

Thanks to everyone taking part—whether you suggest an application, test an installation, share a recipe or report a problem. Every contribution helps make the catalog more useful and reliable for all of us!

[WRCAs]

Application Name: AceStream HTTP Proxy
Description: A HTTP proxy server wrapper for AceStream engine designed to stream content over HTTP.
Category: Media

Container Registry: ghcr.io/martinbjeldbak/acestream-http-proxy
GitHub Repository: https://github.com/martinbjeldbak/acestream-http-proxy

services:
  acestream-http-proxy:
    image: ghcr.io/martinbjeldbak/acestream-http-proxy
    container_name: acestream-http-proxy
    ports:
      - 6878:6878
    restart: unless-stopped

Thanks in advance
Ramón

(media category added)

[MacRimi]

Added, thank you very much for your suggestion.

[pdafoto]

Application: CrossWatch
Image: ghcr.io/cenodude/crosswatch:latest
Where it is published: https://github.com/cenodude/CrossWatch
Category you would expect to find it in: Media & Streaming
Compose file:

services:
  crosswatch:
    image: ghcr.io/cenodude/crosswatch:latest
    container_name: crosswatch
    ports:
      - "8787:8787"
    environment:
      TZ: Europe/Amsterdam
    volumes:
      - crosswatch_config:/config
    restart: unless-stopped

volumes:
  crosswatch_config:

Anything it needs: Just made a custom installation using the oficial compose (adjusting the TZ), it worked for me.

Thanks!

[MacRimi]

Added, thank you very much for your suggestion.

[pdafoto]

Application: Free Games Claimer Remaster
Image: ghcr.io/p-adamiec/free-games-claimer-remaster:latest
Where it is published: https://github.com/P-Adamiec/Free-Games-Claimer-Remaster
Category you would expect to find it in: Gaming & Leisure
Compose file:

# Free Games Claimer Remaster | ProxMenux OCI Manager (stable image)
# Portable template with no passwords or tokens.
# During ADVANCED installation, variables marked "# optional" are offered
# individually: choose Yes if you have the account or TOTP secret.
# Other settings retain the image defaults in v1.16:
# claim DLCs and Epic mobile games, run on startup, report errors
# and summaries, accept Fab/Unity terms, and use DEBUG=true.

name: free-games-claimer-remaster

services:
  fgc:
    image: ghcr.io/p-adamiec/free-games-claimer-remaster:latest
    restart: unless-stopped

    ports:
      - "7080:7080"

    volumes:
      - ./fgc-data:/fgc/data

    shm_size: "1gb"

    environment:
      - TZ=Europe/Madrid
      - SCHEDULER_TIMEZONE=Europe/Madrid
      - SCHEDULER_HOURS=12
      - VNC_LOGIN_TIMEOUT=600
      # Optional: set your own HTTPS reverse-proxy URL (e.g. https://fgc.example.com).
      # Skip this variable when no reverse proxy is configured.
      - VNC_URL= # optional

      # All 14 integrations available in v1.16
      - STORES=steam,epic,prime,gog,microsoft,ubisoft,aliexpress,legacygames,fab,unity,itchio,fanatical,indiegala,alienware

      # Credentials and 2FA are optional to avoid placeholder credentials.
      # *_PASSWORD and *_OTP_KEY are treated as secret fields by the installer.
      - EG_EMAIL= # optional
      - EG_PASSWORD= # optional
      - EG_OTP_KEY= # optional

      - PG_EMAIL= # optional
      - PG_PASSWORD= # optional
      - PG_OTP_KEY= # optional

      - LG_EMAIL= # optional
      - LG_PASSWORD= # optional

      - GOG_EMAIL= # optional
      - GOG_PASSWORD= # optional
      - GOG_OTP_KEY= # optional

      - MS_EMAIL= # optional
      - MS_PASSWORD= # optional
      - MS_OTP_KEY= # optional

      - STEAM_USERNAME= # optional
      - STEAM_PASSWORD= # optional

      - UBI_EMAIL= # optional
      - UBI_PASSWORD= # optional
      - UBI_OTP_KEY= # optional

      - UNITY_EMAIL= # optional
      - UNITY_PASSWORD= # optional

      - AE_EMAIL= # optional
      - AE_PASSWORD= # optional

      - FANATICAL_EMAIL= # optional
      - FANATICAL_PASSWORD= # optional
      - FANATICAL_OTP_KEY= # optional

      - ITCHIO_EMAIL= # optional
      - ITCHIO_PASSWORD= # optional
      - ITCHIO_OTP_KEY= # optional

      - INDIEGALA_EMAIL= # optional
      - INDIEGALA_PASSWORD= # optional

Anything it needs: Successfully installed and tested using OCI Manager Apps (beta), running as an unprivileged LXC without Docker.

Tested resources: 2 vCPU, 4 GB RAM, 16 GB rootfs, 8 GB persistent storage and 1 GB /dev/shm.

The Compose enables all 14 supported integrations, with optional credentials and TOTP secrets entered securely during installation.

Chrome, noVNC (port 7080), authentication and automatic claiming are working correctly. Persistent data and credentials are preserved across updates.

Note: The included Compose leaves VNC authentication disabled, as my installation is only accessible on a trusted private network. Set VNC_PASSWORD if your installation is accessible to other users or exposed externally.

Thanks!

[MacRimi]

Added, thank you very much for your suggestion.

[pdafoto]

Application: MDBListarr

Image: linaspurinis/mdblistarr:2.5.0

Where it is published:

• GitHub: https://github.com/linaspurinis/mdblistarr
• Docker Hub: https://hub.docker.com/r/linaspurinis/mdblistarr

Category: *Arr Suite

Compose file:

services:
  mdblistarr:
    container_name: mdblistarr
    image: linaspurinis/mdblistarr:2.5.0
    ports:
      - "5353:5353"
    environment:
      - PORT=5353
      - TZ=Europe/Madrid
      - CSRF_TRUSTED_ORIGINS= # optional
      - ALLOWED_HOSTS= # optional
    volumes:
      - ./mdblistarr-data:/usr/src/db/
    restart: unless-stopped

Anything it needs:

Successfully installed and tested using ProxMenux OCI Manager's custom Compose importer, running as a native unprivileged LXC without Docker.

Tested configuration:

• 1 vCPU, 1024 MB RAM, 8 GB rootfs
• 2 GB Proxmox-managed persistent volume, included in backups
• Web interface on port 5353
• Initial admin setup and MDBList OAuth authentication working
• Radarr and Sonarr integrations working, including individual media requests
• Plex integration working, including poster badges and audience rating synchronization
• Background scheduler operational

For reverse proxy access, configure CSRF_TRUSTED_ORIGINS and ALLOWED_HOSTS with the appropriate hostname.

The application is working reliably in my initial tests.

[MacRimi]

Added, thank you very much for your suggestion.

[dave100fuegos]

Buenos días como se puede utilizar dos servicio que vienen integrado en un solo docker compose y el mismo no me aparece en el catalogo de imágenes OCI por llamarlo de alguna manera. GRACIAS

https://github.com/timothepoznanski/poznote/blob/main/docker-compose.yml

[MacRimi]

Added, thank you very much for your suggestion.

[gabglus]

Application: Cloudreve

Image: cloudreve/cloudreve:v4

Where it is published:

• GitHub: https://github.com/cloudreve/Cloudreve
• Docker Hub: https://hub.docker.com/r/cloudreve/cloudreve

Category: Cloud Storage / File Management

Compose file:

services:
  cloudreve:
    image: cloudreve/cloudreve:v4
    container_name: cloudreve
    restart: unless-stopped
    ports:
      - "5212:5212"
      - "6888:6888"
      - "6888:6888/udp"
    volumes:
      - ./cloudreve-data:/cloudreve/data

Anything it needs:

Cloudreve is a self-hosted file management and cloud storage platform supporting local storage, S3-compatible storage, OneDrive and other providers. It provides WebDAV, multi-user access, file sharing, resumable uploads and online file previews.

The configuration above uses Cloudreve's single-container deployment. For a production installation with PostgreSQL and Redis, the official deployment also provides a Docker Compose stack with separate database and cache services.

Ports:

• 5212/TCP: Web interface and API.
• 6888/TCP and 6888/UDP: Used for the optional Aria2 remote download functionality.

Persistent storage is required for configuration, application data and related files.

I would appreciate having Cloudreve added to the ProxMenux OCI catalog so it can be installed and managed as a native Proxmox LXC without Docker. Thanks!

[MacRimi]

Added, thank you very much for your suggestion.

[gabglus]

Application: Scanopy

Image:

• Server: ghcr.io/scanopy/scanopy/server:latest
• Daemon: ghcr.io/scanopy/scanopy/daemon:latest
• Database: postgres:17-alpine

Where it is published:

• GitHub: https://github.com/scanopy/scanopy
• Official Docker Compose: https://github.com/scanopy/scanopy/blob/main/docker-compose.yml
• Documentation: https://scanopy.net/docs/

Category: Networking / Network Discovery / Infrastructure Documentation

Compose file:

The official Compose configuration is recommended because Scanopy requires a server, PostgreSQL database, and scanning daemon. It includes the required network access and persistent storage configuration.

Use the official file for the complete deployment:
https://raw.githubusercontent.com/scanopy/scanopy/refs/heads/main/docker-compose.yml

Anything it needs:

Scanopy is a self-hosted network discovery and documentation platform that automatically generates and updates network diagrams. It provides physical (Layer 2), logical (Layer 3), workload, and application dependency views.

Key features include:

• Automatic network and service discovery.
• SNMP, LLDP, and ARP-based network mapping.
• Support for multiple networks and distributed scanning.
• Service identification using more than 230 definitions.
• Scheduled scans and continuously updated diagrams.
• Export to SVG and Mermaid, with additional integrations depending on the edition.

Deployment requirements and considerations:

• PostgreSQL 17 for persistent application data.
• A server listening on TCP port 60072 for the web interface.
• A scanning daemon that requires host networking and elevated network privileges in the official Compose deployment.
• Persistent storage for the database and daemon configuration.
• Optional read-only access to /var/run/docker.sock for Docker service discovery.

For the ProxMenux OCI catalog, it would be especially useful to provide a native LXC deployment that preserves Scanopy's network discovery capabilities without requiring Docker. The daemon's host-networking and privilege requirements should be handled explicitly, since they are essential to reliable network discovery.

The project provides a free Community Edition under the AGPL-3.0 license, as well as commercial self-hosted editions.

I would appreciate having Scanopy added to the ProxMenux OCI catalog. It would be a valuable tool for Proxmox users who want automatically maintained network documentation and infrastructure visibility. Thank you!

[MacRimi]

Added, thank you very much for your suggestion.