Navigation:  CageFS >


Previous pageReturn to chapter overviewNext page

Minimum Requirements:


kernel: CL5 with lve0.8.54 or later, CL6 with lve1.2.17.1 or later, CL7.
7GB of disk space.


Depending on your setup, and number of users, you might also need:

Up to 8MB per customer in /var directory (to store custom /etc directory)

5GB to 20GB in /usr/share directory (to store safe skeleton of a filesystem)


Warning: If at any time you decide to uninstall CageFS, please, make sure you follow uninstall instructions


To install CageFS:


$ yum install cagefs
$ /usr/sbin/cagefsctl --init


That last command will create skeleton directory that might be around 7GB in size. If you don't have enough disk space in /usr/share, use following commands to have cagefs-skeleton being placed in a different location:


$ mkdir /home/cagefs-skeleton
$ ln -s /home/cagefs-skeleton /usr/share/cagefs-skeleton


On cPanel servers, if you will be placing skeleton into /home directory, you must configure the following option in:

cPanel WHM -> Server Configuration -> Basic cPanel/WHM Setup -> Basic Config -> Additional home directories

Change the value to blank  (not default "home")

Without changing this option, cPanel will create new accounts in incorrect places.


CageFS will automatically detect and configure all necessary files for:



Web interface to manage CageFS is available for cPanel, Plesk 10+, DirectAdmin, ISPmanager & Interworx. Command line tool would need to be used for other control panels.


Once you initialized the template you can start enabling users. By default CageFS is disabled for all users.