---
title: "CLI CDN Commands"
description: "Manage CDN deployments, domains, and cache purging from the command line."
url: https://edge.network/docs/cli/cdn/
---

# CLI CDN Commands

CLI

# CDN Commands

Create deployments, manage domains, and purge cache from your terminal.

## Deployments

### List Deployments

```
$ edge cdn list
ID              NAME           DOMAINS    STATUS    CREATED
cdn-abc123      production     3          active    2025-01-15
cdn-def456      staging        1          active    2025-02-01
cdn-ghi789      legacy         2          active    2024-12-10
```

### Create a Deployment

```
$ edge cdn create --name my-cdn

Creating CDN deployment... done

ID:      cdn-jkl012
Name:    my-cdn
Status:  active

Add a domain to start using your CDN:
  edge cdn domains add cdn-jkl012 --domain cdn.example.com --origin https://origin.example.com
```

### Get Deployment Details

```
$ edge cdn get cdn-abc123
ID:           cdn-abc123
Name:         production
Status:       active
Created:      2025-01-15 10:30:00 UTC

Domains:
  cdn.example.com       → https://origin.example.com     SSL: active
  assets.example.com    → storage://my-bucket            SSL: active
  static.example.com    → https://s3.amazonaws.com/...   SSL: active

Statistics (24h):
  Requests:      1,245,678
  Bandwidth:     45.2 GB
  Cache Hit:     94.5%
```

### Delete a Deployment

```
# Delete with confirmation
edge cdn delete cdn-abc123

# Delete without confirmation
edge cdn delete cdn-abc123 --yes
```

## Domains

### List Domains

```
$ edge cdn domains list cdn-abc123
DOMAIN                ORIGIN                           SSL       CACHE TTL
cdn.example.com       https://origin.example.com       active    86400s
assets.example.com    storage://my-assets              active    604800s
static.example.com    https://s3.amazonaws.com/...     active    2592000s
```

### Add a Domain

```
# Add domain with external origin
edge cdn domains add cdn-abc123 \
    --domain cdn.example.com \
    --origin https://origin.example.com \
    --cache-ttl 86400

# Add domain with Storage bucket as origin
edge cdn domains add cdn-abc123 \
    --domain assets.example.com \
    --origin-type storage \
    --storage-bucket my-assets

# Enable JIT image optimization
edge cdn domains add cdn-abc123 \
    --domain images.example.com \
    --origin https://origin.example.com \
    --jit-image
```

### Update a Domain

```
# Update origin
edge cdn domains update cdn-abc123 dom-xyz789 \
    --origin https://new-origin.example.com

# Update cache TTL
edge cdn domains update cdn-abc123 dom-xyz789 \
    --cache-ttl 3600
```

### Remove a Domain

```
edge cdn domains remove cdn-abc123 dom-xyz789
```

## Cache Purging

### Purge All

```
$ edge cdn purge cdn-abc123
Purging all cached content... done

Cache cleared for all domains in cdn-abc123
```

### Selective Purge

```
# Purge specific path
edge cdn purge cdn-abc123 --path /images/*

# Purge specific URL
edge cdn purge cdn-abc123 --url https://cdn.example.com/asset.js

# Purge multiple paths
edge cdn purge cdn-abc123 --path /css/* --path /js/*
```

## Metrics

```
$ edge cdn metrics cdn-abc123
Period: Last 24 hours

Total Requests:     1,245,678
Bandwidth:          45.2 GB
Cache Hit Rate:     94.5%
Cache Misses:       68,412

By Domain:
  cdn.example.com       892,345 requests    32.1 GB
  assets.example.com    312,456 requests    10.8 GB
  static.example.com     40,877 requests     2.3 GB

# Specify time period
edge cdn metrics cdn-abc123 --period 7d

# Filter by domain
edge cdn metrics cdn-abc123 --domain cdn.example.com

# Export as CSV
edge cdn metrics cdn-abc123 --export csv > cdn-metrics.csv
```

## Common Flags

| Flag | Description |
| --name, -n | Deployment name |
| --domain | Domain hostname |
| --origin | Origin URL |
| --origin-type | Origin type: url or storage |
| --storage-bucket | Storage bucket name (when origin-type is storage) |
| --cache-ttl | Cache TTL in seconds |
| --jit-image | Enable JIT image optimization |
| --path | Path pattern to purge |
| --url | Specific URL to purge |
| --yes, -y | Skip confirmation prompts |

## See Also

[DNS Commands Manage zones and records](https://edge.network/docs/cli/dns) [CDN Docs Full CDN documentation](https://edge.network/docs/cdn)
[Back to Docs](https://edge.network/docs) [Need help?](https://edge.network/support)