Custom CDN

By default, all files are served from https://cdn.atiru.io. You can configure your own domain so file URLs use your brand (e.g. https://images.example.com/m/abc123).

Important: set DNS first

Add the CNAME record in your DNS before adding the custom domain in Atiru. If you add the domain in Atiru first, verification will fail. Set the CNAME, wait for DNS to propagate (usually a few minutes), then add the domain in Settings.

How it works

1. In your DNS: Create a CNAME record: images.example.com → cdn.atiru.io (or your chosen subdomain). Wait for propagation.
2. In Atiru: Go to Settings → Custom Domain and enter your hostname (e.g. images.example.com).
3. Click Check Status. When both verification and SSL show active, your domain is ready.
4. New uploads will return public_url and public_download_url using your domain.

Dashboard: Configure

1. First, in your DNS provider: Add a CNAME record pointing your hostname to cdn.atiru.io. Example: name images (for images.example.com), target cdn.atiru.io.
2. Wait for DNS to propagate (a few minutes).
3. Log in to atiru.io, go to Settings.
4. In Custom Domain, enter your hostname (e.g. images.example.com) and add it.
5. Click Check Status until verification and SSL are active.

API: Configure

Set the CNAME in your DNS first, then call:

Endpoint: PATCH /settings

{
  "custom_domain": "images.example.com"
}

To remove: { "custom_domain": null }

To refresh status: { "refresh_custom_domain": true }

curl

curl -X PATCH "https://api.atiru.io/settings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"custom_domain":"images.example.com"}'

Example: Cloudflare DNS

1. Log in to your DNS provider (e.g. Cloudflare).
2. Select your domain (e.g. example.com).
3. Add a record: Type CNAME, Name images (for images.example.com), Target cdn.atiru.io.
4. Save and wait for propagation.

Then add the custom domain in Atiru Settings and click Check Status.

Important

• HTTPS: Your file URLs will use https:// on your hostname. SSL is issued automatically.
• One domain per account: You can have one custom domain. To change it, remove the current one first.