netweft 0.2.0

Deterministic network planning and configuration generation for portable infrastructure.
Documentation

Netweft

Deterministic network planning and configuration generation for portable infrastructure.

Netweft validates stable infrastructure intent, resolves provider-neutral plans, and renders deterministic artifacts. Deployment remains explicit and reviewable.

Documentation

Built-in adapters

bind
cloudflare
docker
env
netplan
proxmox
proxmox-guests
proxmox-sdn
proxmox-storage
ssh
synology-nfs-permissions
systemd-mounts

List the adapters compiled into the current binary:

netweft adapters list

Common inspection workflow

netweft validate
netweft show dns
netweft show proxy
netweft show cloudflare
netweft show ssh --client quasar
netweft show docker --host nexus
netweft show host-network --host zion
netweft show os-network --host quasar
netweft show guests
netweft show proxmox-sdn --host zion
netweft show proxmox-storage --host zion
netweft show network-mounts --host vortex
netweft show nas-permissions

Render only after the resolved plan looks correct, then use the matching deployment guide.

Boundaries

Netweft does not directly:

  • copy files over SSH;
  • configure routers;
  • store secrets;
  • issue certificates;
  • approve Tailscale routes;
  • apply generated artifacts automatically.

Some adapters render guarded apply.sh, verify.sh, and rollback.sh scripts. Running those scripts remains an explicit operator action.

Development verification

cargo fmt --all -- --check
cargo check --all-targets
cargo clippy --all-targets -- -D warnings
cargo test --all-targets
git diff --check