Upload Data to a Push Zone

There are a couple of ways to upload data to a KeyCDN push zone. This guide walks through how to upload data both via FTP(S) and rsync to our CDN storage cloud.

Note: Push Zones are limited to 250’000 files and don’t allow files larger than 5GB.

How to upload Files with FTP/FTPS

  1. If you just created a new push zone, you need to wait a few minutes until your zone is ready.
  2. Connect to the FTP server:
    • Hostname: ftp.keycdn.com
    • Port: 21
    • Username: “Same username as for the dashboard”
    • Password: “Same password as for the dashboard”
  3. Each zone has its own folder with the same name. Copy the data to the according folder.
  4. Newly uploaded content is instantly available from the CDN.

We recommend to use FTPS (explicit FTP over TLS) to avoid plaintext transfer of your credentials over the network.

FTPS Settings for KeyCDN Upload

Verify the connection is using TLS:

FTPS Connection using TLS

Need help uploading content to the FTP server? All you need is an FTP client. We recommend FileZilla.

The fingerprint for ftp.keycdn.com corresponds to:

SHA256: c5:ef:8c:cb:7c:15:20:d4:b0:12:c7:d5:21:75:7f:e8:cf:9f:d9:fb:4c:4d:61:20:96:2c:b2:37:dc:65:ba:c3

How to upload Files with rsync over SSH

If you are interested in lsyncd read this article as well: lsyncd over SSH

  1. Upload ssh public key through the KeyCDN dashboard (Account-Settings > Authentication). It takes a few minutes until the key is distributed on the responsible servers.
  2. Make sure that you added your private key on your system before running rsync (command: ssh-add /path/to/your/private.key).
  3. Upload / synchronise your zone using the following command:
rsync -avz --chmod=u=rwX,g=rX <path_to_your_local_folder>/ <KeyCDN username (from dashboard)>@rsync.keycdn.com:zones/<zone name>/

Example (sync data):

rsync -avz --chmod=u=rwX,g=rX local_folder/ testuser@rsync.keycdn.com:zones/foobar/

If you want to list the files of your zone use a command like this:

rsync --list-only <KeyCDN username (from dashboard)>@rsync.keycdn.com:zones/<zone name>/

Example (list directory):

rsync --list-only testuser@rsync.keycdn.com:zones/foobar/

 
For verification purposes, the SSH fingerprint for rsync.keycdn.com corresponds to:

SHA256:Z/h7sNSBHNJpD7WwLLAeWAXD+ZaxBGLM+RwPHTMKk1k

How Data Gets Deployed via a Push Zone

Now that your data is uploaded to the push zone storage cluster, there are a few things to consider when it comes to deploying this data.

  • New content is uploaded instantly to the storage cluster.
  • If a change is made to an existing file, it takes approximately 15 minutes for that file to be updated (also seen as revalidated in the logs).
  • It is not possible to purge the push content manually.
  • Although your content has been uploaded to  the storage cluster, data is only deployed to an edge server location if it has been requested.