Installation Requirements

ClipBucket installation requirements

This guide explains everything you need to know about running ClipBucket in the best way possible. It covers operating system, hardware, server modules, and common problems after installation.

Pre-installation

Operating system

Linux (CentOS 6, CentOS 6.5, Fedora, Ubuntu)

Required modules

  • Apache
  • MySQL v5.6, 5.7 (major)
  • PHP v7.3 (major)
  • Python 3.6
  • nginx
  • FFmpeg
  • MP4Box
  • FFprobe
  • MediaInfo
  • ImageMagick
  • Elastic Search (optional)
  • PHP Shield
  • MongoDB

Apache

  • mod_rewrite enabled

MySQL

  • Version = 5.5.x, 5.6

PHP CLI

  • Version = PHP 7.0 (with alternatives set to the related version)
  • Support for background processes with exec enabled
  • safe_mode = off
  • open_basedir = off
  • Supports cURL
  • Supports GD2 library
  • Supports ImageMagick
  • max_execution_time = 7200
  • post_max_size = 100M
  • upload_max_filesize = 100M
  • memory_limit = 100M

Note: All sizes should be at least 20–40 MB larger than the file you intend to upload. For example, if you allow uploads up to 100 MB, set PHP limits in the 120–140 MB range or higher.

FFmpeg

  • Version = 2.x
  • Required encoders: libx264, libfdk-aac, libmp3lame, libopus, libvpx

Other binaries (latest)

  • MP4Box
  • FFprobe
  • MediaInfo
  • ImageMagick

Estimated video conversion baseline

  • Videos: 1
  • Size: 100 MB → converted to all 5 resolutions
  • Views: 100

Recommended server specs

  • RAM: 8–10 GB (DDR3)
  • Processor: i5 @ 2.5+ GHz base clock

Above is approximate—scale up or down for your traffic and library size.

Suggested ClipBucket configuration

  • Install the latest version of ClipBucket.
  • Keep the files directory writable at all times.
  • Minimum practical setup: a VPS with at least 5 GB RAM.

Post-installation

You may hit issues that are usually due to misconfigured server or ClipBucket settings. Below are common video conversion problems and fixes.

Video conversion problems

Problem 1

In the admin area you see: “You must update Server Configurations. Click here for details.”

Solution: PHP is usually misconfigured. Set at least:

  • max_execution_time = 7500
  • post_max_size = 100M
  • upload_max_filesize = 100M
  • memory_limit = 100M

Problem 2

All modules are installed, but conversion stays stuck in “processing.”

Solution: Module paths are often wrong. In Admin area → Website configurations → Upload and conversion settings, enter the correct paths for each binary.

Problem 3

Conversion fails without ever starting.

Solution: Often happens with Generate all qualities enabled while a dependency (commonly FFprobe) is broken. FFmpeg never gets valid file info and marks the job failed.

Optional dependencies

  • MongoDB 3.x (for revenue sharing)
  • MongoDB extension for PHP (for revenue sharing)
  • GZIP compression on the web server (for faster delivery)