How to serve static sites?

Q: How to serve static sites?

Create a 'Static Site' in the admin panel, set domain and document root, then save. You can configure index files, directory listing, and cache policies. Ideal for documentation, landing pages, and SPA frontends.

SSLcat includes a high‑performance static server, perfect for documentation, landing pages, and SPA frontends.

Quickstart (Admin Panel)

Login → Sites → New site
Type: Static Site
Set domain (e.g. www.example.com) and document root (e.g. /var/www/example)
Optional: index files, directory listing, cache policy
Save

Common settings

Index files: index.html / index.htm
Directory listing: recommended off
Cache policy: set Cache-Control, e.g. public, max-age=3600

Example (YAML)

static_sites:
  - domain: "www.example.com"
    root: "/var/www/example"
    index_files: ["index.html", "index.htm"]
    enable_dir_listing: false
    cache_control: "public, max-age=3600"
    large_file_threshold_bytes: 104857600

Troubleshooting

404/permission: check doc root exists and permissions allow read.
Cache not applied: verify browser/CDN policies and Cache-Control.
Slow large downloads: enable range/Resume; verify upstream bandwidth.