---
title: "Getting Started with CDN"
description: "Step-by-step guide to deploying a CDN on Edge Network: create a deployment, add a domain and origin, set a CNAME record, and get automatic SSL within a minute."
url: https://edge.network/docs/cdn/getting-started/
---

# Getting Started with CDN

Getting Started

# Deploy Your First CDN

This guide will walk you through creating a CDN deployment and adding your first domain.

## Prerequisites

- An Edge Network account ([sign up here](https://edge.network/console))
- A domain or subdomain you want to serve through the CDN
- Access to your domain's DNS settings
- An origin server (where your content lives - S3, your web server, etc.)

1

## Create a CDN Deployment

A deployment is a container for your CDN domains. You might have one deployment per project or environment.

- Navigate to **CDN** in the sidebar
- Click **Deploy CDN**
- Enter a name for your deployment (e.g., "My Website" or "Production")
- Click **Create Deployment**

2

## Add a Domain

Now add the domain you want to serve through the CDN.

- Click **Add Domain**
- Enter your domain (e.g., `cdn.yoursite.com`)
- Enter your origin URL (e.g., `https://origin.yoursite.com` or an S3 bucket URL)
- Click **Add Domain**

About Origins

The origin is where your actual content lives. This could be an S3 bucket, another CDN,
your web server, or any URL that serves your static files.

3

## Configure DNS

Point your domain to Edge CDN by adding a CNAME record.

Add this CNAME record at your DNS provider:

Type

CNAME

Name/Host

cdn

Value/Target

cdn.edge.network

Replace "cdn" with your subdomain. For a root domain, you may need to use your DNS provider's
CNAME flattening feature or an ALIAS record.

- Log in to your DNS provider (Cloudflare, Route53, etc.)
- Add a CNAME record pointing to `cdn.edge.network`
- Wait for DNS propagation (usually 1-5 minutes)
- Click **Check DNS** in the Edge console

4

## Wait for SSL Certificate

Once DNS is verified, we automatically issue a free SSL certificate for your domain using Let's Encrypt.

SSL: issuing...
SSL: active

Certificate issuance typically takes 30-60 seconds. The page will update automatically.

You're live!

Your domain is now being served through Edge CDN with automatic SSL.
Visit your domain to see it in action.

## Host a Static Site

You can serve a static website directly from an Edge Storage bucket through CDN. Upload your files to a storage bucket,
create a CDN deployment with **Storage Bucket** as the origin type, and add your domain. When using a storage bucket origin,
the CDN automatically serves `index.html` for directory paths — e.g. visiting `example.com/`
serves `index.html` from the bucket root. This gives you a fully static hosting solution with global CDN caching,
automatic SSL, and zero egress fees.

- Create a storage bucket
- Upload your site files (index.html, CSS, JS, images)
- Create a CDN deployment
- Add a domain with origin type **Storage Bucket**
- Your site is live

The agent API can do all of this in one call with `POST /agent/deploy/static-site`.

[Storage documentation →](https://edge.network/docs/storage)

## Test Your CDN

Verify everything is working correctly:

```
# Check the response headers
curl -I https://cdn.yoursite.com/path/to/file.jpg

# Look for these headers:
# x-cache: HIT (served from cache)
# Server: Edge CDN (confirmation that Edge served the request)
```

## Next Steps

[Configuration Presets, caching rules, and image settings](https://edge.network/docs/cdn/configuration) [Image Optimization Resize and optimize images on-the-fly](https://edge.network/docs/cdn/image-optimization) [Caching Understand cache behavior and TTLs](https://edge.network/docs/cdn/caching) [View Analytics Monitor traffic and cache performance](https://edge.network/docs/cdn/analytics)
[Back to Docs](https://edge.network/docs) [Need help?](https://edge.network/support)