{ "schema_version": "0.5.0", "kind": "proxmenux.oci-template", "id": "image-guestroll", "status": "generated-unvalidated", "catalog_ui": { "title": { "en_US": "Guestroll" }, "description": { "en_US": "Self-hosted event photo gallery for guests, with moderation, QR-code sharing, and local SQLite storage." }, "category": "sharing", "category_label": "Files & Sharing", "author": "achedon12", "developer": "achedon12", "icon": "https://raw.githubusercontent.com/achedon12/guestroll/develop/src/app/icon.svg", "thumbnail": null, "screenshots": [], "architectures": [ "amd64", "arm64" ], "launch": { "scheme": "http", "port": 3000, "path": "/admin" }, "website": "https://github.com/achedon12/guestroll", "documentation": "https://github.com/achedon12/guestroll#readme", "repository": "https://github.com/achedon12/guestroll", "tips": [ "Sign in as admin at /admin. ADMIN_PASSWORD is requested at installation; PUBLIC_URL is initially set to the local LXC address.", "Mobile camera access requires HTTPS; configure a reverse proxy before using that feature at an event." ], "mini_changelog": [], "display_version": null, "updated_at": null }, "source": { "provider": "achedon12", "repository": "https://github.com/achedon12/guestroll", "default_branch": "develop", "revision": "3fc407dd872a3e649b7ba505e2e6d80cefb9b82a", "image_repository_url": "https://github.com/orgs/achedon12/packages/container/package/guestroll", "readme_pushed_at": "", "compose_sha256": "a02f45b0aacaf2a5e35a4554f3e35b547dc38011e693390d15f82f6c991c84e5", "generated_at": "2026-10-26T06:12:09+00:00", "readme_raw_url": "https://raw.githubusercontent.com/achedon12/guestroll/develop/README.md" }, "container_contract": { "service_name": "guestroll", "container_name": "guestroll", "image": { "reference": "ghcr.io/achedon12/guestroll:latest", "registry": "ghcr.io", "repository": "ghcr.io/achedon12/guestroll", "tag": "latest", "digest": null, "pull_policy": "resolve-selected-tag-to-architecture-digest-at-install" }, "environment": [ { "name": "ADMIN_PASSWORD", "example": null, "required": true, "sensitive": true, "source": "upstream-documentation" }, { "name": "PUBLIC_URL", "example": "http://@CONTAINER_ADDRESS@:3000", "required": true, "sensitive": false, "container_address": "http://@CONTAINER_ADDRESS@:3000", "source": "upstream-documentation" } ], "volumes": [ { "id": "volume-0", "container_path": "/data", "compose_source_example": "./data", "read_only": false, "required": true, "installation_choice": [ "managed-volume", "host-bind" ], "default": "managed-volume", "managed_volume": { "backup": true, "default_size_gb": 8 } } ], "ports": [ { "container_port": 3000, "published_example": 3000, "protocol": "tcp", "required": true, "proxmox_behavior": "listener-on-dedicated-lxc-address-no-nat" } ], "related_services": [], "restart": "unless-stopped", "stop_grace_period": null, "original_compose": "{\n \"name\": \"guestroll\",\n \"services\": {\n \"guestroll\": {\n \"image\": \"ghcr.io/achedon12/guestroll:latest\",\n \"container_name\": \"guestroll\",\n \"restart\": \"unless-stopped\",\n \"ports\": [\n \"3000:3000/tcp\"\n ],\n \"volumes\": [\n \"./data:/data\"\n ],\n \"environment\": {\n \"ADMIN_PASSWORD\": null,\n \"PUBLIC_URL\": \"http://@CONTAINER_ADDRESS@:3000\"\n }\n }\n }\n}" }, "compose_stack": { "project_name": "guestroll", "deployment_model": "one-native-oci-lxc-per-compose-service", "user_experience": "single-application-install", "main_service": "guestroll", "service_count": 1, "services": [ { "name": "guestroll", "image": "ghcr.io/achedon12/guestroll:latest", "is_main": true, "role": "frontend", "vmid_offset": 0, "depends_on": [], "frontend_network": true, "private_network": false, "compose": { "image": "ghcr.io/achedon12/guestroll:latest", "container_name": "guestroll", "restart": "unless-stopped", "ports": [ "3000:3000/tcp" ], "volumes": [ "./data:/data" ], "environment": { "ADMIN_PASSWORD": null, "PUBLIC_URL": "http://@CONTAINER_ADDRESS@:3000" } } } ], "top_level": {}, "networking": { "frontend": "selected-proxmox-bridge", "private_required": false, "private_creation": "automatic-create-if-missing", "private_address_allocation": "automatic-static-address-per-service", "service_discovery": "private-addresses-with-compose-service-host-aliases", "dependency_external_access": "disabled-unless-service-publishes-ports", "prompt_user_for_private_network": false }, "storage": [ { "id": "guestroll-volume-0", "service": "guestroll", "container_path": "/data", "mode": "managed-volume", "user_selectable": true, "backup": true, "shared_with_other_lxc": false, "source_path": null, "source_path_prompt": null } ], "orchestration": { "reserve_vmids_atomically": 1, "start_order": [ "guestroll" ], "stop_order": [ "guestroll" ], "dependency_readiness": "compose-healthcheck-then-port-or-process-fallback", "rollback_on_failure": "remove-new-rootfs-preserve-created-persistent-volumes" }, "installer_inputs": { "prompted": [ "stack_name", "base_vmid", "rootfs_storage", "persistent_data_destinations", "frontend_bridge", "frontend_ipv4_mode" ], "automatic": [ "dependent_vmids", "private_bridge", "private_subnet", "private_service_addresses", "compose_service_aliases", "generated_secrets", "dependency_start_and_stop_order" ], "generated_secrets": [] } }, "first_run": { "endpoints": [ { "label": "Guestroll", "scheme": "http", "port": 3000, "path": "/admin", "source": "upstream-documentation" } ], "credentials": [ { "label": "Guestroll administrator", "type": "configured-or-installer-generated", "username": "admin", "password": null, "password_environment": "ADMIN_PASSWORD", "change_required": false, "source": "upstream-documentation" } ] }, "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": 120 }, "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" }, "installer_profile": { "generated_sensitive_environment": {}, "volume_preparations": [ { "container_path": "/data", "remove_lost_found": true, "owner_strategy": "mapped-application-user", "only_when_mount_type": "managed-volume" } ], "startup_healthcheck": { "scheme": "http", "port": 3000, "path": "/", "timeout_seconds": 180, "request_timeout_seconds": 10, "stability_seconds": 4, "verify_tls": true } } }, "compatibility": { "automatic_install_candidate": true, "validated": false, "supported_compose_keys": [ "image", "container_name", "environment", "ports", "restart", "volumes", "user" ], "untranslated_blockers": [], "policy": "Single OCI image and one application service. Persistent paths, required settings, listeners and upstream first-run steps are recorded; runtime installation and service behavior remain unvalidated until laboratory testing." }, "validation": { "schema": "passed-at-generation", "clean_install": "pending", "service_health": "pending", "restart_persistence": "pending", "backup_restore": "pending", "update_preserves_data": "pending" }, "lifecycle": { "update_strategy": "resolve-latest-image-then-apply-reviewed-native-lxc-update", "registry_state": { "resolved_architecture": null, "resolved_digest": null, "image_version_label": null, "image_created": null }, "change_detection": "compare-compose-sha256-and-resolved-latest-image-digest", "automatic_unattended_updates": false } }