caddyserver/caddy · error

loading storage module: %v

Error message

loading storage module: %v

What it means

Error "loading storage module: %v" thrown in caddyserver/caddy.

Source

Thrown at modules/caddytls/leafstorageloader.go:61

	storage certmagic.Storage

	ctx caddy.Context
}

// CaddyModule returns the Caddy module information.
func (LeafStorageLoader) CaddyModule() caddy.ModuleInfo {
	return caddy.ModuleInfo{
		ID:  "tls.leaf_cert_loader.storage",
		New: func() caddy.Module { return new(LeafStorageLoader) },
	}
}

// Provision loads the storage module for sl.
func (sl *LeafStorageLoader) Provision(ctx caddy.Context) error {
	if sl.StorageRaw != nil {
		val, err := ctx.LoadModule(sl, "StorageRaw")
		if err != nil {
			return fmt.Errorf("loading storage module: %v", err)
		}
		cmStorage, err := val.(caddy.StorageConverter).CertMagicStorage()
		if err != nil {
			return fmt.Errorf("creating storage configuration: %v", err)
		}
		sl.storage = cmStorage
	}
	if sl.storage == nil {
		sl.storage = ctx.Storage()
	}
	sl.ctx = ctx

	repl, ok := ctx.Value(caddy.ReplacerCtxKey).(*caddy.Replacer)
	if !ok {
		repl = caddy.NewReplacer()
	}
	for k, path := range sl.Certificates {
		sl.Certificates[k] = repl.ReplaceKnown(path, "")

View on GitHub (pinned to 50e54ee279)

Solutions

1. Check the storage module name and configuration; the wrapped error identifies the load failure.

When it happens

Trigger: Thrown at modules/caddytls/leafstorageloader.go:61 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of caddyserver/caddy@50e54ee279 (2026-08-15). Data as JSON: /api/errors/5fe298d46e0e15e4. Report an issue: GitHub.