Documentation
CDNka docs
Everything you need to put a static site, an app bundle or a download mirror behind CDNka.
Quickstart
- Create a pull zone and set your origin, for example
https://origin.example.com. - Add a CNAME record from your subdomain to the zone hostname shown in the dashboard.
- Wait for the certificate (usually under two minutes) and replace asset URLs.
Pull zones
A pull zone maps one hostname to one origin. Requests that miss the cache are fetched from the origin through the shield and stored at the edge.
Cache rules
| Origin header | Edge behaviour |
|---|---|
| Cache-Control: max-age=N | Cached for N seconds |
| Cache-Control: no-store | Not cached, passed through |
| no header | Cached for 4 hours |
| Set-Cookie present | Not cached |
Authentication
API requests use a bearer token from Dashboard → Settings → API tokens. Tokens can be limited to a single zone.
curl https://api.cdnka.xyz/v2/zones \ -H "Authorization: Bearer $CDNKA_TOKEN"
Purge
Purge a single URL, everything under a prefix, or all files with a cache tag. Purges reach every location in under 2 seconds.
POST /v2/zones/{zone}/purge { "urls": ["/img/logo.svg"] } { "prefix": "/build/" } { "tags": ["release-2026-10"] }
Image parameters
| Parameter | Values | Example |
|---|---|---|
| w, h | 1–4096 px | ?w=640 |
| fmt | webp, avif, jpeg, png | ?fmt=avif |
| q | 1–100 | ?q=75 |
| fit | cover, contain, inside | ?fit=cover |
Support
Write to support@cdnka.xyz with your zone name. Team and Business plans get a reply within one business day.