Skip to content
Trailer.devDocumentation

Search is only available in production builds. Try building and previewing the site to test it out locally.

Create Network

The Create Network form showing the driver selector and the macvlan fields.

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) or Macvlan.

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.
  • 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.

Section titled “Related Pages”