Machine Networking

Network configuration and connectivity for Linux machines.

Default Setup

Each machine gets its own virtual network interface connected to the ArcBox network. Outbound internet access works via NAT. No configuration needed.

Connectivity

DirectionHow
Machine → InternetNAT via host (automatic)
Mac → Machine<name>.arcbox hostname or SSH
Machine → Machost.arcbox.internal hostname
Machine → Machine<name>.arcbox hostnames

Port Access

All ports on a machine are accessible from your Mac via the .arcbox domain. There is no need to forward individual ports.

# Machine "dev" running multiple services
curl http://dev.arcbox:3000    # Web app
curl http://dev.arcbox:5432    # PostgreSQL
ssh dev.arcbox                  # SSH (port 22)

Static IP

Machines receive a stable IP address from the ArcBox DHCP server. The address persists across reboots.

You can view a machine's IP in the Desktop app (machine detail view) or via:

arcbox machine inspect dev --format '{{.NetworkSettings.IPAddress}}'

DNS Inside the Machine

Machines can resolve:

  • Public hostnames (via upstream DNS)
  • Other machine names (<name>.arcbox)
  • Container names (when on the same network)

On this page