Configuration

CDN Configuration

Fine-tune your CDN behavior with presets, caching rules, and image optimization settings.

Configuration Presets

Start with a preset optimized for your use case, then customize as needed.

Static Website

Long cache times for assets, short for HTML. Perfect for blogs, marketing sites, and documentation.

E-commerce

Optimized for product catalogs with frequent updates. Caches images aggressively, bypasses cart/checkout.

Media & Streaming

Large file handling with long TTLs. Ideal for video platforms, podcasts, and file downloads.

API Gateway

Minimal caching with origin pass-through. Good for APIs that need CDN's global network without caching.

Custom

Full control with JSON configuration. Define your own caching rules and image optimization settings.

Screenshot: Preset selection in the Configuration tab

Custom Configuration

For advanced use cases, you can define custom rules using JSON. Switch to "Advanced (JSON)" mode in the Configuration tab.

{
  "caching": {
    "defaultTtl": 86400,
    "respectOriginHeaders": true,
    "rules": [
      { "path": "/static/**", "ttl": 31536000 },
      { "path": "/api/**", "bypassCache": true },
      { "path": "/assets/*.css", "ttl": 604800 }
    ]
  },
  "imageOptimization": {
    "enabled": true,
    "defaultQuality": 85,
    "defaultFormat": "auto",
    "rules": [
      { "path": "/thumbnails/**", "quality": 70, "maxWidth": 400 },
      { "path": "/hero/**", "quality": 90, "format": "avif" }
    ]
  }
}

Caching Rules

Define path-based rules to control how different content is cached.

Property	Type	Description
`path`	string	Path pattern to match (supports * and ** wildcards)
`ttl`	number	Cache duration in seconds
`bypassCache`	boolean	Skip caching entirely for matched paths
`ignoreQueryString`	boolean	Cache without considering query parameters

Rules are evaluated in order. The first matching rule wins. If no rules match, the default TTL is used.

Path Patterns

Use glob-style patterns to match paths:

*

Matches any characters except /

**

Matches any characters including /

# Match all files in /static/ and subdirectories
/static/**

# Match only .jpg files in /images/
/images/*.jpg

# Match a specific path
/assets/logo.png

# Match all API routes
/api/**

Image Optimization Settings

Configure default image optimization behavior and path-specific rules.

Property	Type	Description
`enabled`	boolean	Enable/disable image optimization entirely
`defaultQuality`	number (1-100)	Default compression quality for images
`defaultFormat`	string	Default output format: `auto`, webp, avif, jpeg, png

Auto Format

Set defaultFormat to auto to automatically serve the best format based on browser support. The CDN checks the browser's Accept header and serves AVIF → WebP → JPEG in order of preference.

Cache Purge Required

Changing defaultQuality or defaultFormat only affects newly cached images. Existing cached images will continue to use the old settings until they expire or you purge the cache.

Image Optimization Rules

Override image optimization settings for specific paths:

Property	Type	Description
`path`	string	Path pattern to match
`quality`	number	Override compression quality
`format`	string	Override output format
`maxWidth`	number	Maximum width in pixels

Simple vs Advanced Mode

Simple Mode

Use form controls to set basic options:

Default cache TTL
Enable/disable image optimization
Default quality and format

Advanced Mode

Full JSON configuration for:

Path-based caching rules
Cache bypass for specific paths
Per-path image optimization rules

Next Steps

Caching

Understand cache behavior in depth

Image Optimization

URL parameters for on-the-fly transforms