2026-10-26 07:16:45 +01:00
{
"schema_version" : "0.5.0" ,
"kind" : "proxmenux.oci-template" ,
"id" : "image-flagr" ,
"status" : "generated-unvalidated" ,
"catalog_ui" : {
"title" : {
"en_US" : "Flagr"
},
"description" : {
"en_US" : "Self-hosted feature-flag and experimentation service with a web interface and SQLite defaults."
},
"category" : "ai" ,
"category_label" : "AI / Coding & Dev-Tools" ,
"author" : "openflagr" ,
"developer" : "openflagr" ,
"icon" : "https://raw.githubusercontent.com/openflagr/flagr/main/docs/brand/flagr-mark.png" ,
"thumbnail" : null ,
"screenshots" : [],
"architectures" : [
"amd64" ,
"arm64"
],
"launch" : {
"scheme" : "http" ,
"port" : 18000 ,
"path" : "/"
},
"website" : "https://github.com/openflagr/flagr" ,
"documentation" : "https://github.com/openflagr/flagr/blob/main/docs/flagr_self_host.md" ,
"repository" : "https://github.com/openflagr/flagr" ,
"tips" : [
"This profile uses Flagr's built-in SQLite mode; no MySQL or PostgreSQL service is required."
],
"mini_changelog" : [],
"display_version" : null ,
"updated_at" : null
},
"source" : {
"provider" : "openflagr" ,
"repository" : "https://github.com/openflagr/flagr" ,
"default_branch" : "main" ,
"revision" : "e026211babf05b0cc3431b6deb565f65df7ae3c7" ,
"image_repository_url" : "https://github.com/orgs/openflagr/packages/container/package/flagr" ,
"readme_pushed_at" : "" ,
"compose_sha256" : "ec4044f5b9f5c33c67ed266efd16be2b0d4c929c7a6ce7fa3b03d858fc0f93d5" ,
"generated_at" : "2026-10-26T06:12:09+00:00" ,
"readme_raw_url" : "https://raw.githubusercontent.com/openflagr/flagr/main/README.md"
},
"container_contract" : {
"service_name" : "flagr" ,
"container_name" : "flagr" ,
"image" : {
"reference" : "ghcr.io/openflagr/flagr:latest" ,
"registry" : "ghcr.io" ,
"repository" : "ghcr.io/openflagr/flagr" ,
"tag" : "latest" ,
"digest" : null ,
"pull_policy" : "resolve-selected-tag-to-architecture-digest-at-install"
},
"environment" : [
{
"name" : "HOST" ,
"example" : "0.0.0.0" ,
"required" : true ,
"sensitive" : false ,
"source" : "upstream-documentation"
},
{
"name" : "FLAGR_DB_DBDRIVER" ,
"example" : "sqlite3" ,
"required" : true ,
"sensitive" : false ,
"source" : "upstream-documentation"
},
{
"name" : "FLAGR_DB_DBCONNECTIONSTR" ,
"example" : "/data/flagr.sqlite" ,
"required" : true ,
"sensitive" : false ,
"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" : 4
}
}
],
"ports" : [
{
"container_port" : 18000 ,
"published_example" : 18000 ,
"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\": \"flagr\",\n \"services\": {\n \"flagr\": {\n \"image\": \"ghcr.io/openflagr/flagr:latest\",\n \"container_name\": \"flagr\",\n \"restart\": \"unless-stopped\",\n \"ports\": [\n \"18000:18000/tcp\"\n ],\n \"volumes\": [\n \"./data:/data\"\n ],\n \"environment\": {\n \"HOST\": \"0.0.0.0\",\n \"FLAGR_DB_DBDRIVER\": \"sqlite3\",\n \"FLAGR_DB_DBCONNECTIONSTR\": \"/data/flagr.sqlite\"\n }\n }\n }\n}"
},
"compose_stack" : {
"project_name" : "flagr" ,
"deployment_model" : "one-native-oci-lxc-per-compose-service" ,
"user_experience" : "single-application-install" ,
"main_service" : "flagr" ,
"service_count" : 1 ,
"services" : [
{
"name" : "flagr" ,
"image" : "ghcr.io/openflagr/flagr:latest" ,
"is_main" : true ,
"role" : "frontend" ,
"vmid_offset" : 0 ,
"depends_on" : [],
"frontend_network" : true ,
"private_network" : false ,
"compose" : {
"image" : "ghcr.io/openflagr/flagr:latest" ,
"container_name" : "flagr" ,
"restart" : "unless-stopped" ,
"ports" : [
"18000:18000/tcp"
],
"volumes" : [
"./data:/data"
],
"environment" : {
"HOST" : "0.0.0.0" ,
"FLAGR_DB_DBDRIVER" : "sqlite3" ,
"FLAGR_DB_DBCONNECTIONSTR" : "/data/flagr.sqlite"
}
}
}
],
"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" : "flagr-volume-0" ,
"service" : "flagr" ,
"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" : [
"flagr"
],
"stop_order" : [
"flagr"
],
"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" : "Flagr" ,
"scheme" : "http" ,
"port" : 18000 ,
"path" : "/" ,
"source" : "upstream-documentation"
}
],
"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" : 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"
}
],
2026-10-26 07:47:18 +01:00
"volume_owner" : {
"uid" : 100 ,
"gid" : 101
},
2026-10-26 07:16:45 +01:00
"startup_healthcheck" : {
"scheme" : "http" ,
"port" : 18000 ,
"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
}
}
