ts_dump_folder
The `ts_dump_folder` directive specifies the folder where thumbnail snapshots are saved.
Description
The ts_dump_folder directive is used within the Kaltura Media Framework Common NGINX Module configuration to designate the path for storing thumbnail snapshots generated during media processing. This directive is applicable in the http, server, and location contexts, allowing administrators the flexibility to set the thumbnail save location according to their organizational structure or server architecture.
The argument for this directive is a single path string that indicates the folder's location on the filesystem where the thumbnail files will be stored. It is crucial that the specified directory has the proper permissions set to allow NGINX to write files to it, otherwise, attempts to save thumbnails will fail and may result in missed snapshots or errors in media delivery. This can be particularly important in production environments where seamless media processing is required.
Before using this directive, ensure that the directory exists and is writable by the NGINX user. If the specified directory does not exist, thumbnail generation may not function correctly. Administrators should monitor the folder regularly to manage its size and contents, especially in high-traffic scenarios where thumbnail generation is frequent.
Config Example
server {
listen 80;
location /media/ {
ts_dump_folder /var/www/thumbnails;
}
}Ensure the specified directory exists and is writable by the NGINX user.
Monitor the dump folder regularly for file size management, especially under high load.
Incorrect paths may lead to configuration errors or processing failures.