.cagefs is part of CloudLinux CageFS, a virtualized filesystem that isolates each cPanel user's environment. It enhances security by preventing users from accessing each other's files and system resources.
Benefits of CageFS:
The .cagefs folder is usually found in:
/home/username/.cagefs/
If .cagefs is missing or corrupt, users may experience website errors or command failures.
Run the following command:
cagefsctl --force-update
cagefsctl --enable username
cagefsctl --remount username
Replace username with the actual cPanel username.
Restart CageFS:
cagefsctl --remount-all
If a user cannot access files inside .cagefs, it might be due to incorrect permissions.
cagefsctl --remount username
To reset for all users:
cagefsctl --remount-all
If the issue persists, force an update:
cagefsctl --force-update
Sometimes, users cannot run basic commands like php, ls, or wget inside CageFS.
cagefsctl --update
If that does not work, reinitialize the environment:
cagefsctl --reinit
If you want to completely disable CageFS for a specific user:
cagefsctl --disable username
cagefsctl --disable-all
This should only be done if necessary, as disabling CageFS removes security protections.
| Issue | Fix |
|---|---|
| Missing .cagefs folder | Run cagefsctl --force-update |
| Permission denied inside .cagefs | Run cagefsctl --remount username |
| Commands not found inside 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!