The .cagefs folder is a CloudLinux CageFS directory that exists in each cPanel user's home directory. It provides a virtualized, secure file system to isolate users from each other.
Location of .cagefs Folder:
/home/username/.cagefs/
Key Functions of .cagefs:
If .cagefs is missing or corrupt, users may experience website errors, permission issues, or missing commands.
cagefsctl --force-update
cagefsctl --remount username
Replace username with the actual cPanel username.
If the issue persists, fully disable and re-enable CageFS for that user:
cagefsctl --disable username
cagefsctl --enable username
If a user cannot access files inside .cagefs, it could be due to incorrect permissions.
cagefsctl --remount username
chmod -R 755 /home/username/.cagefs
To apply to all users, run:
cagefsctl --remount-all
Restart services after fixing permissions:
service cpanel restart
Sometimes, users inside CageFS cannot run basic commands like php, ls, or wget.
cagefsctl --update
If that doesn't work, reinitialize the CageFS environment:
cagefsctl --reinit
Check if commands are available after the update.
If you need to disable CageFS for a specific user:
cagefsctl --disable username
cagefsctl --disable-all
Disabling CageFS removes security protections, so do this only if necessary.
| Issue | Fix |
|---|---|
| .cagefs missing or incomplete | Run cagefsctl --force-update && cagefsctl --remount username |
| Permission denied in .cagefs | Run chmod -R 755 /home/username/.cagefs |
| Commands not working in CageFS | Run cagefsctl --update or cagefsctl --reinit |
| Disable CageFS for a user | Run cagefsctl --disable username |
Now CageFS should work properly, and your users will be securely isolated!