Hostnames

The Hostnames page is where you manage the domains and subdomains routed to a zone. Every hostname attached here inherits the zone's configuration -- proxy and origin, caching, security, optimization, and routing. A hostname goes live the moment its DNS CNAME record points to smoxy: from then on, incoming requests for it are handled with the zone's settings.

The Hostnames page, where you attach domains to a zone.

---

Adding a Hostname

1. Open your Zone and go to Hostnames
2. Enter the hostname you want to route to this zone (e.g., www.example.com)
3. Add it -- the hostname now appears in the Configured hostnames table
4. At your DNS provider, point the hostname's CNAME record at the CNAME target smoxy shows for it in the table

Once the CNAME resolves to smoxy, traffic for the hostname is served by the zone -- with all of the zone's settings applied automatically.

INFO

Note: A hostname also needs a valid SSL certificate before it can serve HTTPS traffic. smoxy can issue one automatically -- see How SSL Works.

---

The Configured Hostnames Table

The Configured hostnames table lists every hostname attached to the zone, with the following columns:

Column	What It Shows
Hostname	The domain or subdomain routed to this zone
CNAME target	The value to point the hostname's DNS CNAME record at
DNS status	Whether the hostname's CNAME currently points to smoxy
CDN	Whether the CDN (caching & optimization) is active for this hostname -- Enabled or Disabled

---

Per-Hostname Actions

Each hostname has an actions menu:

Action	What It Does
Visit site	Opens the hostname in your browser
Enable CDN / Disable CDN	Toggles whether the CDN is active for this hostname
Move to zone	Moves the hostname to a different zone
Convert to redirect	Turns the hostname into a redirect instead of serving content
Delete hostname	Removes the hostname from the zone

The per-hostname actions menu.

Enable CDN / Disable CDN

This toggle controls whether the CDN -- caching and optimization -- is active for the hostname. Disable it when you want smoxy to pass traffic through without caching or optimizing it.

INFO

Note: Disabling the CDN turns off caching and optimization only. Security and proxy handling can still apply to the hostname even with the CDN disabled.

Move to Zone

Moving a hostname to another zone reattaches it to the destination zone you select. The hostname immediately inherits that zone's settings -- no need to reconfigure anything manually.

This action appears only when your organization has at least one other zone to move the hostname to.

Convert to Redirect

When a hostname should forward traffic to another address instead of serving content, convert it to a redirect. See Redirects for how redirects work.

The Convert hostname to a redirect dialog: redirect target and redirect mode.

---

DNS Status

The DNS status reflects whether the hostname's CNAME record correctly points to smoxy. smoxy runs a per-hostname DNS check, so you can confirm at a glance which hostnames are routed correctly and which still need their CNAME updated.

TIP

If a hostname's DNS status indicates it is not pointing to smoxy, re-check that its CNAME record matches the CNAME target shown in the table. DNS changes can take some time to propagate before the status updates.

---

Hostnames, Zones, and SSL

Hostnames are how a zone's configuration reaches live traffic. The connection is the CNAME-points-to-smoxy mechanism: as long as a hostname's CNAME resolves to smoxy, every request for it is served with the zone's settings. Change the zone's configuration and the change applies to all of its hostnames at once.

Two things have to be in place for a hostname to serve traffic over HTTPS:

Requirement	Why It Matters
CNAME to smoxy	Routes incoming requests for the hostname through smoxy so the zone's settings apply
SSL certificate	Lets the hostname serve HTTPS -- smoxy can issue one automatically

For more on how zones group hostnames under one configuration, see What is a Zone?. For certificates, see How SSL Works.