Files
ProxMenux/oci/catalog/apps/mediaelch.json
T
MacRimiandClaude Opus 5 bcabcb618c feat(oci): run official container images as native LXC containers
Adds the OCI manager: an engine that turns a Docker Compose file into an
LXC definition, a catalog of 365 applications drawn from LinuxServer.io
and other container image sources, and a per-instance registry recording
what each container was built from. Reachable from the main menu.

Catalog text is translated like every other string in the project: the
taglines go through translate() and land in lang/*.json, so the entries
read in all eight languages instead of only English.

Translation cache builder:
- a failed translation leaves the key absent rather than writing English,
  which previously made the string count as translated forever
- a result identical to a 3+ word source is rejected, catching a provider
  that silently returns the text it was given
- strings that are nothing but glossary terms keep their source spelling
  instead of being discarded as failures
- no backoff between attempts when the provider is deterministic
- application names are protected so "HAOS One" survives translation
- argos joins the provider list, and the workflow reads the OCI sources

Audit & Report:
- findings that moved in the wrong direction between runs are reported
  alongside the ones that improved
- an accepted risk can carry a review date and is flagged when it falls due
- backup checks explain in plain language what they looked at and what to
  do next

Monitor:
- disks can be excluded from periodic reads, and an idle disk says so
  instead of showing a stale temperature
- per-disk identity survives a controller or enclosure change
- scheduled Borg backups resolve their SSH key from the repository entry
- PVE upgrades log the package list and the resulting dpkg changes

The web build no longer copies scripts/ into public/: the documentation
links to GitHub, so nothing read that folder.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-22 18:24:59 +02:00

373 lines
13 KiB
JSON

{
"schema_version": "0.3.0",
"kind": "proxmenux.oci-template",
"id": "linuxserver-mediaelch",
"status": "generated-unvalidated",
"catalog_ui": {
"title": {
"en_US": "Mediaelch"
},
"tagline": {
"en_US": "MediaElch is a MediaManager for Kodi. Information about Movies, TV Shows, Concerts and Music are stored as nfo files. Fanarts are downloaded automatically from fanart.tv. Using the nfo generator, MediaElch can be used with other MediaCenters as well."
},
"description": {
"en_US": "MediaElch is a MediaManager for Kodi. Information about Movies, TV Shows, Concerts and Music are stored as nfo files. Fanarts are downloaded automatically from fanart.tv. Using the nfo generator, MediaElch can be used with other MediaCenters as well."
},
"category": "misc",
"category_label": "Miscellaneous",
"author": "LinuxServer.io",
"developer": null,
"icon": "https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/mediaelch-icon.png",
"thumbnail": "https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/mediaelch-banner.png",
"screenshots": [],
"architectures": [
"amd64"
],
"launch": {
"scheme": "https",
"port": 3001,
"path": "/"
},
"website": "https://github.com/Komet/MediaElch",
"documentation": "https://docs.linuxserver.io/images/docker-mediaelch/",
"repository": "https://github.com/linuxserver/docker-mediaelch",
"tips": [],
"mini_changelog": [
{
"date": "2026-04-19",
"note": "Rebase to Debian Trixie, ingest appimage from github."
},
{
"date": "2026-04-03",
"note": "Make Wayland default disable with PIXELFLUX_WAYLAND=false."
},
{
"date": "2025-12-28",
"note": "Add Wayland init logic."
},
{
"date": "2025-08-14",
"note": "Rebase to noble, ingest latest stable version, install qt deps."
},
{
"date": "2025-07-12",
"note": "Rebase to Selkies, HTTPS IS NOW REQUIRED."
}
],
"display_version": null,
"updated_at": "2026-04-19"
},
"source": {
"provider": "linuxserver.io",
"repository": "https://github.com/linuxserver/docker-mediaelch",
"default_branch": "master",
"revision": "7ba5da55e8c859d6826a04938fae346cd052c14e",
"readme_raw_url": "https://raw.githubusercontent.com/linuxserver/docker-mediaelch/7ba5da55e8c859d6826a04938fae346cd052c14e/README.md",
"readme_pushed_at": "2026-09-05T16:19:19Z",
"compose_sha256": "e1297511a1d3929f55f196692260c756387dda61d2e72bc61daad6a5da485980",
"generated_at": "2026-09-12T14:37:31+00:00"
},
"container_contract": {
"service_name": "mediaelch",
"container_name": "mediaelch",
"image": {
"reference": "lscr.io/linuxserver/mediaelch:latest",
"registry": "lscr.io",
"repository": "lscr.io/linuxserver/mediaelch",
"tag": "latest",
"digest": null,
"pull_policy": "resolve-selected-tag-to-architecture-digest-at-install"
},
"environment": [
{
"name": "PUID",
"example": "1000",
"required": true,
"sensitive": false,
"source": "linuxserver-compose"
},
{
"name": "PGID",
"example": "1000",
"required": true,
"sensitive": false,
"source": "linuxserver-compose"
},
{
"name": "TZ",
"example": "Etc/UTC",
"required": true,
"sensitive": false,
"source": "linuxserver-compose"
},
{
"name": "LC_ALL",
"example": "",
"required": false,
"sensitive": false,
"source": "upstream-documentation",
"prompt": "Language/locale (e.g. es_ES.UTF-8; translation of every application is not guaranteed)"
}
],
"volumes": [
{
"id": "volume-0",
"container_path": "/config",
"compose_source_example": "/path/to/mediaelch/config",
"read_only": false,
"required": true,
"installation_choice": [
"managed-volume",
"host-bind"
],
"default": "managed-volume",
"managed_volume": {
"backup": true,
"default_size_gb": 4
}
}
],
"ports": [
{
"container_port": 3000,
"published_example": 3000,
"protocol": "tcp",
"required": true,
"proxmox_behavior": "listener-on-dedicated-lxc-address-no-nat"
},
{
"container_port": 3001,
"published_example": 3001,
"protocol": "tcp",
"required": true,
"proxmox_behavior": "listener-on-dedicated-lxc-address-no-nat"
}
],
"related_services": [],
"restart": "unless-stopped",
"stop_grace_period": null,
"original_compose": "---\nservices:\n mediaelch:\n image: lscr.io/linuxserver/mediaelch:latest\n container_name: mediaelch\n environment:\n - PUID=1000\n - PGID=1000\n - TZ=Etc/UTC\n volumes:\n - /path/to/mediaelch/config:/config\n ports:\n - 3000:3000\n - 3001:3001\n shm_size: \"1gb\"\n restart: unless-stopped\n"
},
"first_run": {
"endpoints": [
{
"label": "Web UI",
"scheme": "https",
"port": 3001,
"path": "/",
"source": "linuxserver-readme-application-setup"
}
],
"credentials": []
},
"proxmox": {
"runtime": "native-oci-lxc",
"technology_status": "proxmox-technology-preview",
"defaults": {
"unprivileged": true,
"ostype": "auto-from-image",
"cores": 2,
"memory_mb": 1024,
"swap_mb": 512,
"rootfs_size_gb": 8,
"rootfs_storage": "local-lvm",
"volume_storage": "local-lvm",
"template_storage": "local",
"bridge": "vmbr0",
"ipv4": "dhcp",
"firewall": true,
"host_managed_network": true,
"onboot": false,
"features": [
"nesting=1"
],
"shutdown_timeout_seconds": 30
},
"image_metadata_policy": {
"entrypoint": "import-from-oci-image",
"cmd": "import-from-oci-image",
"environment": "import-image-env-then-apply-compose-overrides",
"user": "import-from-oci-image",
"working_dir": "import-from-oci-image",
"stop_signal": "import-from-oci-image"
},
"adaptations": [
{
"id": "dedicated-lxc-network",
"upstream_behavior": "Docker publishes selected container ports on the Docker host.",
"native_lxc_behavior": "The application listens on the same container ports at its dedicated LXC address.",
"reason": "A native LXC has its own address and does not require Docker port NAT.",
"behavioral_impact": "Users open the LXC address instead of the Proxmox host address.",
"validation": "pending-per-application"
},
{
"id": "compose-environment-overlay",
"upstream_behavior": "Compose environment values override OCI image environment values.",
"native_lxc_behavior": "ProxMenux merges the same values into lxc.environment.runtime while the CT is stopped.",
"reason": "PVE imports image Env automatically; Compose values still need to override it.",
"behavioral_impact": "None expected.",
"validation": "pending-per-application"
},
{
"id": "stop-grace-period",
"upstream_behavior": "Docker waits for Compose stop_grace_period before forcing termination.",
"native_lxc_behavior": "ProxMenux records the same timeout for its pct shutdown lifecycle operations.",
"reason": "Proxmox has no equivalent per-CT persistent restart-policy field; startup.down is not a shutdown timeout.",
"behavioral_impact": "Normal Proxmox node shutdown remains governed by the node-wide shutdown policy.",
"validation": "not-requested-by-compose"
},
{
"id": "compose-shm-size",
"upstream_behavior": "Compose sets the size of the container /dev/shm tmpfs.",
"native_lxc_behavior": "ProxMenux mounts a native LXC tmpfs at /dev/shm with the same requested capacity.",
"reason": "The OCI image runs directly as an LXC and therefore needs the equivalent Proxmox mount entry.",
"behavioral_impact": "None expected.",
"validation": "pending-per-application"
}
],
"installer_profile": {
"tmpfs_mounts": [
{
"id": "compose-shm",
"container_path": "/dev/shm",
"default_size_mb": 1024,
"minimum_size_mb": 1,
"size_prompt": "Size of the /dev/shm shared memory in MB",
"mount_options": [
"rw",
"nosuid",
"nodev"
]
},
{
"id": "nginx-runtime",
"container_path": "/run/nginx",
"default_size_mb": 1,
"minimum_size_mb": 1,
"prompt_size": false,
"mount_options": [
"rw",
"nosuid",
"nodev",
"mode=0755"
]
}
],
"selkies": {
"base": "FROM ghcr.io/linuxserver/baseimage-selkies:debiantrixie",
"dockerfile_url": "https://raw.githubusercontent.com/linuxserver/docker-mediaelch/master/Dockerfile",
"dockerfile_sha256": "4291ab245dee3d06037908bc3e51b079c352756901809177244185e41e80dfe0",
"reviewed_on": "2026-09-16",
"documentation": "https://docs.linuxserver.io/images/docker-baseimage-selkies/",
"nvidia": "not-offered-until-specific-host-and-image-validation",
"validation": "profile-generated; real streaming workload pending"
},
"optional_devices": [],
"hardware_acceleration": {
"prompt": "Selkies desktop and streaming acceleration",
"default": "none",
"profiles": [
{
"id": "none",
"label": "No GPU (CPU)",
"device_requests": [],
"environment": [
{
"name": "AUTO_GPU",
"value": "false"
}
]
},
{
"id": "vaapi",
"label": "Intel/AMD (streaming rendering and encoding)",
"device_requests": [
{
"id": "selkies-render",
"kind": "character-device",
"path_prompt": "Intel/AMD render node",
"host_path_default": "/dev/dri/renderD128",
"container_path_strategy": "same-as-host",
"mode": "0660",
"deny_write": false,
"gid_strategy": "host-device-gid",
"drm_vendor_ids": [
"0x8086",
"0x1002"
]
}
],
"environment": [
{
"name": "PIXELFLUX_WAYLAND",
"value": "true"
},
{
"name": "AUTO_GPU",
"value": "false"
}
],
"environment_from_devices": {
"DRINODE": [
"selkies-render"
],
"DRI_NODE": [
"selkies-render"
],
"ATTACHED_DEVICES_PERMS": [
"selkies-render"
]
}
}
]
},
"gpu_validation": {
"device_inventory": "host-sysfs-and-stat",
"application_acceleration": "requires-workload-test",
"tone_mapping": "not-implied-by-device-access"
},
"device_permissions": {
"strategy": "linuxserver-native-init",
"service_user": "abc",
"environment": "ATTACHED_DEVICES_PERMS",
"paths": "all-resolved-selected-character-devices"
}
}
},
"compatibility": {
"automatic_install_candidate": true,
"validated": false,
"supported_compose_keys": [
"container_name",
"environment",
"image",
"ports",
"restart",
"shm_size",
"stop_grace_period",
"volumes"
],
"untranslated_blockers": [],
"policy": "A generated template is never promoted to validated without install, health, restart and persistence tests."
},
"validation": {
"schema": "passed-at-generation",
"clean_install": "pending",
"service_health": "pending",
"restart_persistence": "pending",
"backup_restore": "pending",
"update_preserves_data": "pending"
},
"lifecycle": {
"update_strategy": "replace-rootfs-from-new-oci-image-preserve-managed-volumes",
"registry_state": {
"resolved_architecture": null,
"resolved_digest": null,
"image_version_label": null,
"image_created": null
},
"change_detection": "compare-resolved-architecture-digest",
"automatic_unattended_updates": false
}
}