Configuring Videocache is very easy. The configuration file for videocache is located at /etc/videocache.conf. Below is a brief explanation of different options used in videocache.conf.
If you change options in configuration file, please use the to update the videocache installation and restart Videocache as explained on page.
Click on the option name to get the details.
This option controls the global behavior of videocache plugin. If it is 0, videocache will stop caching or serving anything. This option’s value can be either 0 or 1.
Default value:
The option client_email must be set appropriately otherwise videocache will not work.
Please set this option to the email address using which you purchased Videocache license.
Default value:
When offline mode is enabled, videocache will serve the videos already in cache and will skip caching the new videos. When set to 0, videocache will cache new video and when set to 1, videocache will serve the already cached videos and will not cache the new videos it encounters.
Default value:
The option videocache_user must be set appropriately otherwise videocache will not work.
Use this option to set the user which should be running videocache scheduler. This user must be same as the squid user. On RedHat/CentOS/SuSE, it's generally squid and on Debian/Ubuntu/BSDs, it generally proxy.
Default value:
Please change cache_host to actual IP address or domain name of your proxy server, otherwise videocache will not work properly.
The hostname or IP address of the system on which caching is being done. This is used for serving the videos from the cache. Please don’t use http:// or slashes (/). Just specify the domain name or IP address.
Example : proxy.example.com
Additionally you can specifiy an alternative port to for HTTP. Example : 192.168.36.204:81
Default value:
Base directories for caching the videos. You can specify multiple caching directories here separated by '|' symbol.
Example: To keep /videocache1 and /videocache2 as your cache directories, set base_dir to
base_dir = /videocache/ | /videocache2
Please avoid special characters in directory names like whitespaces, $ etc.
Default value:
base_dir = /var/spool/videocache/
The maximum number of parallel cache processes allowed. If all connections are consumed, videos will be queued for caching.
Default value:
Use proxy option only when Videocache server should go through another proxy server.
Proxy to be used for caching videos via HTTP.
Example : http://proxy.example.com:3128/ or http://192.0.2.25:8080/
Default value:
If the proxy server specified using proxy option requires authentication, please specify the username.
Default value:
If the proxy server specified using proxy option requires authentication, please specify the password.
Default value:
No of times a video should be requested before we cache it.
Default value:
The video of size more than max_video_size (MegaBytes) will not be cached.
Example : If max_video_size = 50, videocache will not cache videos of size more than 50MB. Set this to 0 to disable this check. Don't append MB.
Default value:
The video of size less than min_video_size (MegaBytes) will not be cached.
Example : If min_video_size = 2, videocache will not cache videos of size less than 2MB. Set this to 0 to disable this check. Don't append MB.
Default value:
This option sets the minimum available free space in Mega Bytes that is left in a partition containing a cache directory before videocache treats that partition as FULL.
Example : If disk_avail_threshold = 200, videocache will stop caching videos in a cache directory if the free space available in that cache directory is less than 200 Mega Bytes.
Default value:
disk_avail_threshold = 1000
Enables the videocache cleaner script which will remove videos from cache which have not been used since long. The value of this option can be 0 or 1.
Default value:
enable_videocache_cleaner = 1
The maximum life of a video in cache without being used. If the video was not accessed for more than video_lifetime days, it'll be removed from the cache. The unit of video_lifetime is days.
Example : video_lifetime = 15 will remove videos which were not used since last 15 or more days.
Default value:
Directory where videocache logs will be stored.
Default value:
logdir = /var/log/videocache/
The name of log file can be specified using different logfile options. Please avoid any special characters in filename.
Default Values:
logfile = videocache.log
scheduler_logfile = scheduler.log
cleaner_logfile = cleaner.log
tracefile = trace.log
Maximum size of logfiles specified above. The size is in mega bytes. The log files will be rotated once they exceed the maximum specified size.
Please don’t use max_logfile_size = 10MB. Don’t append MB.
Default Values:
max_logfile_size = 10
max_scheduler_logfile_size = 10
max_cleaner_logfile_size = 10
max_tracefile_size = 10
The logfiles are automatically rotated once they have exceeded the max_logfile_size. The max_logfile_backups is the number of backup files you want to keep.
Example : max_logfile_backups = 2 will keep videocache.log and videocache.log.1 and videocache.log.2 as logfiles.
Default Values:
max_logfile_backups = 10
max_scheduler_logfile_backups = 10
max_cleaner_logfile_backups = 5
max_tracefile_backups = 1
XMLRPC server is used for memory sharing across different instances of videocache. Leave these settings as it is if you don't have a fair idea of XMLRPC. This will be 127.0.0.1 in most cases.
Default value:
Please make sure this port is not currently in use. If it is in use by some other program, change this to some port above 1024 which is not in use by any other program.
Default value:
This option enables the caching of Youtube videos. This option’s value can be either 0 or 1.
Default value: