caddyserver/caddy · error

parsing network address: %v

Error message

parsing network address: %v

What it means

Error "parsing network address: %v" thrown in caddyserver/caddy.

Source

Thrown at caddyconfig/httpcaddyfile/addresses.go:339

		} else {
			lnCfgVals = []addressesWithProtocols{{
				addresses: []string{""},
				protocols: nil,
			}}
		}
	}

	// use a map to prevent duplication
	listeners := map[string]map[string]struct{}{}
	for _, lnCfgVal := range lnCfgVals {
		for _, lnAddr := range lnCfgVal.addresses {
			lnNetw, lnHost, _, err := caddy.SplitNetworkAddress(lnAddr)
			if err != nil {
				return nil, fmt.Errorf("splitting listener address: %v", err)
			}
			networkAddr, err := caddy.ParseNetworkAddress(caddy.JoinNetworkAddress(lnNetw, lnHost, lnPort))
			if err != nil {
				return nil, fmt.Errorf("parsing network address: %v", err)
			}
			if _, ok := listeners[addr.String()]; !ok {
				listeners[networkAddr.String()] = map[string]struct{}{}
			}
			for _, protocol := range lnCfgVal.protocols {
				listeners[networkAddr.String()][protocol] = struct{}{}
			}
		}
	}

	return listeners, nil
}

// addressesWithProtocols associates a list of listen addresses
// with a list of protocols to serve them with
type addressesWithProtocols struct {
	addresses []string
	protocols []string

View on GitHub (pinned to 50e54ee279)

Solutions

1. Check that the listener address uses a valid host:port or network/address format supported by Caddy.
2. Remove typos, extra colons, or unsupported components from the address in the Caddyfile.

When it happens

Trigger: Thrown at caddyconfig/httpcaddyfile/addresses.go:339 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/e1f36065b04bfa2b. Report an issue: GitHub.