hashicorp/nomad · error

unknown network: %s

Error message

unknown network: %s

What it means

ReattachConfigToGoPlugin's network switch fell through to default: the Network field is not one of tcp/tcp4/tcp6/udp/udp4/udp6/unix/unixgram/unixpacket, so the reattach address cannot be resolved.

Source

Thrown at plugins/shared/structs/plugin_reattach_config.go:54

		addr, err := net.ResolveTCPAddr(rc.Network, rc.Addr)
		if err != nil {
			return nil, err
		}
		plug.Addr = addr
	case "udp", "udp4", "udp6":
		addr, err := net.ResolveUDPAddr(rc.Network, rc.Addr)
		if err != nil {
			return nil, err
		}
		plug.Addr = addr
	case "unix", "unixgram", "unixpacket":
		addr, err := net.ResolveUnixAddr(rc.Network, rc.Addr)
		if err != nil {
			return nil, err
		}
		plug.Addr = addr
	default:
		return nil, fmt.Errorf("unknown network: %s", rc.Network)
	}

	return plug, nil
}

// ReattachConfigFromGoPlugin converts a go plugin ReattachConfig into a
// ReattachConfig wrapper struct
func ReattachConfigFromGoPlugin(plug *plugin.ReattachConfig) *ReattachConfig {
	if plug == nil {
		return nil
	}

	rc := &ReattachConfig{
		Protocol: string(plug.Protocol),
		Network:  plug.Addr.Network(),
		Addr:     plug.Addr.String(),
		Pid:      plug.Pid,
	}

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Set the reattach network to a supported value such as "unix" or "tcp"
2. Verify the serialized reattach config was not truncated or corrupted

When it happens

Trigger: Thrown at plugins/shared/structs/plugin_reattach_config.go:54 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of hashicorp/nomad@482b49bf1a (2026-09-04). Data as JSON: /api/errors/b0caedad26124c43. Report an issue: GitHub.