Custom Domains

Add a CNAME file to claim one or more custom hostnames for a deployment.

CNAME

fullstack-example.w7s.io
www.fullstack-example.w7s.io

W7S reads CNAME from the deployed archive. Common locations include:

CNAME
frontend/CNAME
frontend/dist/CNAME
dist/CNAME
build/CNAME
out/CNAME

DNS

Create DNS for each hostname and point it at W7S.

For a subdomain, create a proxied CNAME:

Type: CNAME
Name: fullstack-example
Target: w7w.cloud
Proxy: enabled

TXT security allowlist

The first custom-domain claim can work without TXT verification. W7S still recommends adding a TXT record to restrict future claims.

For a host under w7s.io, add:

Type: TXT
Name: _w7s.w7s.io
Value: w7s-io/example-fullstack-ts

TXT values can list owners or exact repositories:

w7s-io
w7s-io/docs
w7s-io/docs,guerrerocarlos

If multiple repositories try to claim the same hostname, the TXT allowlist decides which repository is allowed.