caddyserver/caddy · error

provisioning fallback encoder module: %v

Error message

provisioning fallback encoder module: %v

What it means

Error "provisioning fallback encoder module: %v" thrown in caddyserver/caddy.

Source

Thrown at modules/logging/appendencoder.go:82

// CaddyModule returns the Caddy module information.
func (AppendEncoder) CaddyModule() caddy.ModuleInfo {
	return caddy.ModuleInfo{
		ID:  "caddy.logging.encoders.append",
		New: func() caddy.Module { return new(AppendEncoder) },
	}
}

// Provision sets up the encoder.
func (fe *AppendEncoder) Provision(ctx caddy.Context) error {
	fe.ctx = ctx
	fe.repl = caddy.NewReplacer()

	if fe.WrappedRaw == nil {
		// if wrap is not specified, default to JSON
		fe.wrapped = &JSONEncoder{}
		if p, ok := fe.wrapped.(caddy.Provisioner); ok {
			if err := p.Provision(ctx); err != nil {
				return fmt.Errorf("provisioning fallback encoder module: %v", err)
			}
		}
		fe.wrappedIsDefault = true
	} else {
		// set up wrapped encoder
		val, err := ctx.LoadModule(fe, "WrappedRaw")
		if err != nil {
			return fmt.Errorf("loading fallback encoder module: %v", err)
		}
		fe.wrapped = val.(zapcore.Encoder)
	}

	return nil
}

// ConfigureDefaultFormat will set the default format to "console"
// if the writer is a terminal. If already configured, it passes
// through the writer so a deeply nested encoder can configure

View on GitHub (pinned to 50e54ee279)

Solutions

1. Fix the fallback encoder module configuration; the wrapped error identifies the problem.

When it happens

Trigger: Thrown at modules/logging/appendencoder.go:82 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/ab655d21b08acc8c. Report an issue: GitHub.