Command line tools

Navigation:  CageFS >

Command line tools

Previous pageReturn to chapter overviewNext page

cagefsctl is used to manage CageFS. It allows you to initialize and update CageFS, as well as enable/disable CageFS for individual users.


Usage: /usr/sbin/cagefsctl [OPTIONS]




-i | --init

initialize CageFS (create CageFS if it does not exist)

-r | --reinit

reinitialize CageFS (make backup and recreate CageFS)

-u | --update

update files in CageFS (add new and modified files to CageFS, remove unneeded files)


update /etc template only

-f | --force

recreate CageFS (do not make backup, overwrite existing files)

-d | --dont-clean

do not delete any files from skeleton (use with --update option)

-k | --hardlink

use hardlinks if possible


Creates /etc/cagefs/ file


mount CageFS skeleton directory and start cagefs-fuse service (if not started)


unmount CageFS skeleton directory and stop cagefs-fuse service (if started)


disable CageFS, remove templates and /var/cagefs directory


add rpm-packages in CageFS (run "cagefsctl --update" in order to apply changes)


remove rpm-packages from CageFS (run "cagefsctl --update" in order to apply changes)


list rpm-packages that are installed in CageFS

-e | --enter

enter into user's CageFS as root


enable CageFS


disable CageFS


Set min UID


Display current MIN_UID setting


assume "yes" in all queries (should be the first option in command)


set minimum period for doing update of a skeleton (default 1 day)


forces the update even if min period is yet to be reached


forces clean up of all user's tmp directories


set command to run to clean up end user tmp directories, like: --set-tmpwatch='/usr/sbin/tmpwatch -umclq 720'

-m | --remount

remount specified user(s)

-M | --remount-all

restart cagefs-fuse service, remount CageFS skeleton directory and all users, (use this each time you have changed file)

-w | --unmount

unmount specified user(s)

-W | --unmount-all

stop cagefs-fuse service, unmount CageFS skeleton directory and all users

--create-virt-mp  USERNAME

creates file for Plesk user


creates file for all Plesk users

-l | --list

list users that entered in CageFS


enable CageFS for the user


disable CageFS for the user


enable all users, except specified in /etc/cagefs/users.disabled


disable all users, except specified in /etc/cagefs/users.enabled


display current mode ("Enable All" or "Disable All")


toggle mode saving current lists of users, (lists of enabled and disabled users remain unchanged)


list enabled users


list disabled users


display prefix for user


configure CageFS integration with other software (control panels, database servers, etc)


self test, checking if CageFS works properly