Ingesting with FTP

You can use FTP to upload videos, thumbnails, closed captions, and manifest files to Backlot.

Note: This topic applies to both OIS v2.5 and OIS v1. Certain sections, where indicated, apply to just one version.

Overview of FTP Ingest

About FTP

FTP is a standard network protocol for transferring files from one computer to another. Most operating systems support FTP natively, and you can choose from many FTP client applications. You can automate FTP uploads by writing scripts, have users bulk upload videos through a Windows, Mac, or Linux application, or have users bulk upload videos through a browser (e.g., FireFTP).
Note: You can use any FTP client to upload videos to Backlot.

Account Policy

Your account is limited to a maximum of 100GB on the ingestion server at any time. If you expect to upload more content, you can request a temporary increase from your Customer Success Manager or Technical Support.

Getting Ingest Credentials

You need to obtain ingest credentials in order to upload files to Ooyala via FTP.

Setting Up an Upload-only User in Backlot (OIS v2.5)

Note: If you want to use both basic and manifest-based ingestion, you need to create separate, uniquely-named, upload-only user accounts for each (for example, and
  1. In the Backlot GUI (Account > User Management), add a user with Upload Only permissions to your account (see Managing Users).
  2. Configure the password for this account.
  3. Use the email and password associated with this user to log into the ingestion endpoint (see Ooyala Ingest Server Endpoints).
Note: If you want to use manifest-based ingest, contact Ooyala to enable this functionality for your account.

Obtaining Ingest Credentials from Ooyala Support (OIS v1)

Note: Ooyala must know that you plan to use FTP and must provide you with credentials before you can begin uploading content.

To use FTP, contact Ooyala Support:

  • Indicate that you want to use FTP to upload content to Ooyala.
  • Indicate whether you want to use manifest-based ingestion and provide metadata through an XML or CSV manifest file.

After submitting a support request, Ooyala Support will provide you with a set of credentials, similar the following example.
username: d0b206YlR6etqD1HscU4iP3R223
password: 2kg15iBvOo3fVfg

Ingesting with an FTP Client

You can upload a video via FTP either with or without a manifest.
Note: All upload files must comply with the ingest requirements described in Supported Ingest Formats

Uploading Your File(s) via FTPs (OIS v2.5)

Note: OIS v2.5 requires an FTPS (FTP over SSL) client.
  1. Prepare the file(s) you want to upload.
  2. Launch your FTPS client program.
  3. Log into the ingest endpoint (see Ooyala Ingest Server Endpoints) using the credentials (email and password) of your Backlot upload-only user account.
  4. Upload the file(s) you want to ingest (videos, thumbnails, closed caption files, and so on). If you are using a manifest file, be sure to upload all of the files that are referenced in the manifest file.
  5. Ooyala suggests that you upload the manifest file last.
Files are deleted right after they are all processed. Submitted files that do not go through the entire ingestion workflow (for example, awaiting the upload of the manifest file) are deleted from the server after 7 days.

Uploading Your File(s) via FTP (OIS v1)

Note: If your uploads include a manifest file, upload the manifest file last. Any content files referenced in the manifest file must be uploaded before the manifest file itself.
  1. Prepare videos to upload.
  2. Locate your credentials provided by Ooyala. For example:
    username: 11amo6qGw2oucN78R-BYbDpCESk
    password: 2kg15iBvOo3fVfg
  3. Select one of the following FTP endpoints: (UK/EMEA), (Asia/Pacific), or (All others).
  4. Start your FTP client and begin uploading to the root directory of the selected FTP endpoint. Videos uploaded to any subdirectories will be ignored.
    Note: If you are using a UI-based tool, you specify your credentials in the UI. If you are using a command-line tool, your request looks similar to: ftp://username:password@endpoint (for example: For more information, refer to the FTP client's documentation.
    Note: With a basic FTP account, Backlot immediately begins processing any uploaded videos. With a CSV or XML FTP account, Backlot will not begin processing the video(s) until after the metadata file is uploaded.
  5. Continue uploading videos until you are finished.
  6. Upload the manifest file, if applicable.
  7. To check whether the videos processed successfully, see Ingestion Log and Error Messages (OIS v1).
If a video specified in the manifest file cannot be found, the video is ignored.

Was this article helpful?