CNX Documentation

aliases.yml format

One line per name:

www.example.com.: cdn.some-provider.net.
example.com.:     app.some-platform.io.

Rules

  • CNX derives the published TTL from the target's own TTL, matching it every time it checks the target again.
  • Each name is managed in exactly one place — aliases.yml or zone.conf.
  • CNX blocks an alias when the name is itself a more specific zone delegated elsewhere (aliasing api.example.com. fails if api.example.com is its own separately delegated zone).
  • Remove a line to stop managing that name — CNX removes the published record on the next cycle.
  • If the target fails to resolve, or returns a CNAME of its own, CNX logs the failure and leaves the name unpublished — check your activity report if a name isn't showing up as expected.

See Setting up aliases.yml for why and when to use this, and CNAME flattening for the underlying mechanism.