Help

Guides and troubleshooting. Expand a section for details.

What are Spaces?

Spaces may be used to tag links (like Gmail labels) and to store default IP and HTTP/HTTPS port combinations. If you work with two or more servers, create one Space per environment with the correct defaults.

When adding a link, select the Space and leave IP/port blank—the link inherits the Space routing. Updating a Space’s routing applies to all links in that Space that rely on those defaults.

Spaces API reference

How SkipDNS works

Each request to a preview URL is forwarded to the server at the IP you configured (or to the IP the domain resolves to if you did not set one). Responses are rewritten so references to the real site hostname use the preview address instead, so pages, forms, and assets load through the proxy.

SkipDNS does not write proxied page content to disk. Operational data is limited to access logs (see Access logs). The consent page explains preview behavior on first visit to each alias.

Missing images or broken layout

References to the main site and www are rewritten to your preview alias. Other subdomains are proxied through SkipDNS but forwarded to whatever IP public DNS returns—not necessarily the IP on the link form.

Missing images often mean a subdomain still points at old or offline hosting, or the origin blocks hotlinking from unknown referrers (your preview subdomain looks like a third-party site to the asset server).

If you are validating a migration, ask the destination host to check subdomain routing, PHP version, and hotlink rules. On the link form, wildcard / multisite chooses whether only the apex and www use the routing settings you configure there (other subdomains follow normal DNS), or every subdomain does.

I cannot receive the activation e-mail

Check your spam or junk folder and wait a few minutes—delivery can be delayed. Make sure you signed up with the correct address (typos are common).

If nothing arrives, try another e-mail address or contact us and we can help complete activation.

Automation and pre-filled URLs

REST API v2 is included on every plan—see Developers.

To pre-fill the link creation form, open a URL with the server IP and destination in the path (replace the placeholders in the examples below). A hostname alone defaults to HTTPS; include http:// or a full URL in the destination segment when you need an explicit protocol or path. For IPv6, colons in the address can confuse some clients—use square brackets around the IP when needed (both forms work).

https://skipdns.link/203.0.113.10/example.com
https://skipdns.link/2001:db8::1/example.com
https://skipdns.link/[2001:db8::1]/example.com
https://skipdns.link/203.0.113.10/https://example.com/blog
https://skipdns.link/203.0.113.10/http://legacy.example/old-site

For cPanel end customers, use the free cPanel plugin.

Hosting providers: server-wide Flexible SSL

SkipDNS discourages Flexible SSL—use it only as a last resort when a preview cannot load over HTTPS any other way. Current cPanel releases typically install a self-signed SSL certificate on new accounts by default, which is enough for HTTPS previews without Flexible SSL in most cases.

If you still need server-wide support—for example legacy servers without auto SSL, or apps that break unless Apache sees HTTPS—add the following to global Apache includes or your vhost template so customers do not have to edit each .htaccess:

SetEnvIf X-Forwarded-Proto https HTTPS=on
SetEnvIf X-Forwarded-Proto https SERVER_PORT=443

SkipDNS sends X-Forwarded-Proto and X-SkipDNS-Proto; prefer the forwarded-proto form when you can so the same rules also cover Cloudflare Flexible SSL, load balancers, and other reverse proxies.

Per-account troubleshooting (including .htaccess and app config) is described in Help → HTTPS and blank pages.

cPanel plugin documentation · API for bulk or custom integrations

What access logs do you keep?

We retain standard access log fields: URL requested, timestamp, user agent, visitor IP, bytes transferred, HTTP status, and referrer when present. This is similar to what origin web servers typically log.

Forwarded requests include the visitor IP in headers; many origins log SkipDNS’s IP instead, which can add a layer of separation (not guaranteed).

See also Terms.

cPanel plugin

Install the SkipDNS cPanel plugin so customers create preview links from cPanel—free-slot defaults, paid slots, Flexible SSL, wildcard, API tokens, and updates are documented here:

cPanel plugin documentation

How do custom domains work?

A custom domain must be a registrable apex (top-level) hostname such as example.com or example.co.uk. Subdomains like links.example.com are not accepted.

The domain must use Cloudflare DNS—this is required, with no alternative.

Set it up from the Domains page in your dashboard: add the domain and provide a Cloudflare API token with at least these permissions:

Use a Cloudflare API token for this zone with at least these permissions:

Checkbox Policy name
DNS & Zones → DNS → Edit DNS Write
DNS & Zones → Zone → Read Zone Read
DNS & Zones → Zone Settings → Edit Zone Settings Write
Rules & Configuration → Zone Transform Rules → Edit Zone Transform Rules Write
Cache & Performance → Cache Settings → Edit Cache Settings Write

SkipDNS then creates DNS records for the domain and its wildcard, turns off selected Cloudflare zone settings that rewrite HTML/JS during migration previews, adds a cache bypass rule, and adds a security header rule.

Need more? Contact