EpicGames/lore · error

Missing replicated store settings

Error message

Missing replicated store settings

What it means

Thrown by configure_immutable_store_via_plugin when mode is "replicated" but settings.immutable_store.replicated is None. A replicated store needs its replication settings (peers, quorum, etc.) to build; the missing section aborts startup.

Solutions

1. Add an [immutable_store.replicated] section with peer/quorum settings.
2. Check the subsection key spelling against the Settings schema.
3. Use a mode whose settings block exists in the current config.

Example fix

# before
[immutable_store]
mode = "replicated"

# after
[immutable_store]
mode = "replicated"
[immutable_store.replicated]
peers = ["node1:7000", "node2:7000"]

if settings.immutable_store.mode == "replicated" && settings.immutable_store.replicated.is_none() {
    return Err(anyhow!("mode=replicated requires [immutable_store.replicated] settings"));
}

fn replicated_store_configured(s: &ImmutableStoreSettings) -> bool {
    s.mode != "replicated" || s.replicated.is_some()
}

When it happens

Trigger: immutable_store.mode = "replicated" in config while settings.immutable_store.replicated is None (missing [immutable_store.replicated] subsection).

Common situations: Enabling replicated mode in a config migrated from single-node local mode; omitted peer/quorum settings; subsection typo preventing deserialization.

Understand the failure class

Background: "is required", "must be set", "missing required field": configuration validation errors across open-source libraries — this error's family across 36 libraries.

Related errors

• Missing local immutable store settings
• Missing composite store settings
• Missing remote immutable store settings
• Failed to create immutable store plugin
• [environment.endpoint] auth_url is set but [server.auth] is…

AI-assisted analysis of EpicGames/lore@074eb0b0d1 (2026-09-13). Data as JSON: /api/errors/dc3da16ddd945d4f. Report an issue: GitHub.

Appendix: source

Thrown at lore-server/src/server.rs:905

                .ok_or(anyhow!("Missing local immutable store settings"))?;

            configure_local_immutable_store(local_settings).await
        }
        store_mode::COMPOSITE => {
            let composite_settings = settings
                .immutable_store
                .composite
                .as_ref()
                .ok_or(anyhow!("Missing composite store settings"))?;

            configure_composite_store(registry, composite_settings, settings, topology).await
        }
        store_mode::REPLICATED => {
            let replicated_settings = settings
                .immutable_store
                .replicated
                .as_ref()
                .ok_or(anyhow!("Missing replicated store settings"))?;

            configure_replicated_immutable_store(replicated_settings).await
        }
        store_mode::REMOTE => {
            let remote_settings = settings
                .immutable_store
                .remote
                .as_ref()
                .ok_or(anyhow!("Missing remote immutable store settings"))?;

            configure_remote_immutable_store(remote_settings)
        }
        _ => {
            // All other modes use the plugin system
            let plugin_config =
                resolve_plugin_config_with_fallback(&settings.plugins, mode, "immutable_store")
                    .unwrap_or_else(|| toml::Value::Table(toml::map::Map::new()));

View on GitHub (pinned to 074eb0b0d1)