Skip to content

ADR-0001: No IPv6 in Phase 1

Status

Accepted

Context

The HomeOps Server Foundation is in its initial Phase 1, focusing on establishing a stable, understandable, and rebuildable single-node Proxmox VE environment.

The primary goals of this phase are: - To create a predictable management network - To minimize unnecessary complexity - To ensure that all configuration choices are fully understood and documented

Although IPv6 is supported by Proxmox VE and modern Linux systems, it introduces additional considerations related to addressing, routing, firewalling, and exposure that are not strictly required for the initial foundation phase.

The server is currently deployed in a home network environment where IPv4 is the dominant and well-understood protocol, and where upstream IPv6 behavior may vary depending on ISP and router configuration.

Decision

IPv6 will not be configured or enabled on the Proxmox VE host during Phase 1 of the HomeOps Server Foundation.

The management network will operate using IPv4 only.

This decision applies specifically to: - The Proxmox VE host management interface - Host-level networking configuration

IPv6 may be revisited in a later phase once the base system, access model, and security baseline are fully established.

Consequences

Positive

  • Reduced attack surface during the initial foundation phase
  • Simpler network configuration and troubleshooting
  • Clear and predictable management access behavior
  • Easier documentation and rebuildability

Negative

  • IPv6-only services or environments are not supported at this stage
  • Future IPv6 adoption will require additional configuration and documentation work

Notes

This decision does not represent a rejection of IPv6 as a technology. It is a deliberate scope and complexity management choice aligned with the goals of Phase 1.

IPv6 support may be introduced in a later phase as a documented and intentional architectural change.