Create Network
Create a new container network on a host. A new network starts in the Pending state and moves to Created once the agent reconciles it.
Basic information
Section titled “Basic information”- Name: required.
- Description: optional.
- Host: required. The dropdown is filtered to hosts where you hold the network create permission. If a host is missing, you likely lack that permission on it.
- Driver:
Bridge(default) orMacvlan.
Macvlan fields
Section titled “Macvlan fields”Selecting the Macvlan driver reveals extra fields:
- Parent interface: the physical NIC on the host that the network attaches to. The dropdown lists only the interfaces the agent reported for the selected host, so pick the host first. If the NIC you want is not listed, see Host Interface Detection. The usual cause is a NIC that is down or has no IP address assigned.
- Subnet (IPv4 CIDR): required. The LAN subnet in CIDR form, for example
10.0.0.0/24. Must be canonical. - Gateway: required. An IPv4 address inside the subnet, for example
10.0.0.1. - IP range (optional): a sub-pool in CIDR form, for example
10.0.0.128/25. It must be canonical and fall inside the subnet. Leave blank to use the whole subnet.
These values are validated in the form and again server-side. Bridge networks have none of these fields.
A workspace attaching to a macvlan network may also set a static IPv4 address for its own endpoint. That is part of the workspace attach flow, not this form.
Permissions
Section titled “Permissions”Grant other users access to the network. Each permission row has three flags:
- Attach: attach the network to a workspace.
- Modify: edit the network.
- Delete: remove the network.
See Permissions and access control for the full model.