Setting up aliases.yml

If a name needs to point at something that only gives you a CNAME target — a CDN, a SaaS platform, a load balancer you don't control — put it in aliases.yml instead of zone.conf. This is CNX's mechanism for CNAME flattening: CNX resolves the target on your behalf and publishes the matching records for that name directly — see CNAME flattening for why this is necessary at all.

One line per name:

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

Each name is managed in exactly one place — aliases.yml or zone.conf, never both. Add it via the same branch/commit/push/merge-request flow as any other zone change — see Managing zone changes.

See aliases.yml format for the full set of rules: TTL handling, delegation conflicts, and what happens if a target stops resolving.