Skip to main content
Tusky lets you serve your decentralized storage content through your own branded domain. Instead of https://myproject.mytusky.xyz, your users see https://cdn.yourdomain.com — with automatic SSL provisioning and the same CDN performance.

​
Setup Guide

1

Choose your domain

Decide which domain or subdomain you want to use for your aggregator. Common choices include:
  • cdn.yourdomain.com
  • files.yourdomain.com
  • assets.yourdomain.com
  • storage.yourdomain.com
2

Add a CNAME record

In your DNS provider’s management console, create a CNAME record pointing your chosen domain to your Tusky aggregator:
TypeNameValueTTL
CNAMEcdn{subdomain}.mytusky.xyz3600
Replace {subdomain} with your Tusky aggregator subdomain.
If you are using Cloudflare as your DNS provider, set the proxy status to DNS only (gray cloud) to allow Tusky to provision the SSL certificate.
3

Configure in Tusky

Once DNS is propagated, add the custom domain in Tusky:
Navigate to Settings → Aggregator → Custom Domain and enter your domain (e.g. cdn.yourdomain.com).
4

SSL auto-provisioned

Tusky automatically provisions a TLS certificate for your custom domain. This typically completes within a few minutes. You can verify SSL is active by visiting your domain in a browser.
5

Verify

Test that your custom domain is serving content correctly:
curl -I https://cdn.yourdomain.com/v1/blobs/your_blob_id
You should see a 200 OK response with the correct content headers.

​
SSL Certificates

Tusky handles SSL certificates automatically:
  • Certificates are provisioned via Let’s Encrypt at no additional cost.
  • Renewal is automatic — you never need to manually manage certificates.
  • Both HTTP/2 and HTTP/3 are supported on custom domains.
SSL provisioning requires the CNAME record to be correctly configured and propagated. If provisioning fails, double-check your DNS settings and ensure your DNS provider is not proxying the record.

​
DNS Propagation

DNS changes can take up to 48 hours to propagate globally, though most providers complete propagation within minutes. You can verify propagation with: 
dig CNAME cdn.yourdomain.com
The response should show your Tusky aggregator as the CNAME target.

​
Removing a Custom Domain

To remove a custom domain and revert to your default *.mytusky.xyz URL:
Navigate to Settings → Aggregator → Custom Domain and click Remove.
After removing a custom domain, traffic to that domain will no longer be served by Tusky. Make sure to update any references to the custom domain in your applications.

​
What’s Next

Aggregator Overview

Understand how the full aggregator infrastructure works.

Analytics

Monitor traffic on your custom domain.