Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

create

Create a NIC

Usage

ionosctl compute nic create [flags]

Aliases

For nic command:

[n]

For create command:

[c]

Description

Use this command to add a new NIC (Network Interface Card) to a server. The NIC attaches the server (--server-id) to a LAN (--lan-id) inside the given Data Center (--datacenter-id). If the target LAN does not exist yet, it is created implicitly when the NIC is created.

Addressing options:

  • DHCP (default): with --dhcp=true the NIC reserves an IP automatically from the LAN's DHCP server. This is the usual choice.

  • Static/reserved IPs: pass --ips to assign specific addresses. Explicitly assigned public IPs must come from reserved IP blocks; private-range addresses (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) may be assigned on private LANs. Leaving --ips empty lets IONOS pick an address automatically.

Firewall: --firewall-active toggles the per-NIC firewall (off by default). When active, all incoming traffic is blocked except what explicit firewall rules allow; when inactive, rules are ignored and traffic reaches the NIC directly. --firewall-type selects which traffic direction those rules govern (INGRESS/EGRESS/BIDIRECTIONAL).

IPv6: --ipv6-cidr-block, --ipv6-ips and --dhcpv6 only apply when the target LAN has IPv6 enabled; --ipv6-ips must fall within the NIC's IPv6 CIDR block.

Use --wait (-w) to wait for the NIC to reach AVAILABLE state before the command returns.

Required values to run a command:

  • Data Center Id

  • Server Id

Options

Examples

Last updated

Was this helpful?