Networking

Networking on the canvas covers three real node types: private networks, primary IPs, and floating IPs. You wire them to compute nodes with edges, not fields. See The canvas model for the model behind edges.

This section only documents the live networking features. VPC and serverless networking strategies are scaffolded and not usable yet.

Private networks

A private network node is a real network resource on your provider, such as a Hetzner private network or a Google Cloud VPC.

Drag one from the palette and set its fields in the inspector:

• The IP range, such as 10.0.0.0/16.
• The subnet IP range.
• The network zone, where the provider supports one.

To put a compute node in a private network, draw an edge from the private network node to the compute node. That edge is the membership. There is no networkId field to type on the compute node.

A compute node can be in more than one private network. The exact cardinality is governed by provider rules that the backend owns, and the canvas enforces them as you draw.

Primary IPs

A primary IP is the public IP address that comes with a compute node when it has public internet access enabled.

The primary IP node is a canvas companion, not a separate resource you manage. You do not drag it from the palette. You create it by turning on the public IP toggle on a compute node, and it is deleted when you delete the compute node.

The primary IP shows the live public IP address of its parent compute node. Its edge runs from the compute node to the primary IP, so it reads visually as the IP flowing out of the server.

Primary IPs are auto-managed

You cannot draw edges to or from a primary IP node. It is fully managed by its parent compute node.

Floating IPs

A floating IP is a real, independently-managed public IP resource. For Hetzner this is a Floating IP. For Google Cloud this is a static external address.

Drag a floating IP node from the palette and set its fields:

• The IP type, IPv4 or IPv6.
• The home location.
• A description.

To assign a floating IP to a compute node, draw an edge from the floating IP node to the compute node. The edge means “this IP is assigned to this compute.” A floating IP can be assigned to at most one compute node at a time. A compute node can have many floating IPs.

Because a floating IP is a real resource, it survives the compute node it is assigned to. Delete the compute node and the floating IP stays. You can reassign it later by dragging its edge to another compute node.

How they connect

Edge	From	To	Meaning
Membership (private network)	private network	compute	Compute is in this network.
Membership (floating IP)	floating IP	compute	This IP is assigned to this compute.
Companion (primary IP)	compute	primary IP	This public IP belongs to this compute, managed automatically.

Next

• Node types lists every field on each networking node.
• Plan and Apply covers what happens when you apply network changes.
• The canvas model explains edge-derived membership in depth.