Filesystem Layout
Complete reference for Simuzo directory structure and file locations.
Main Directory
/usr/local/simuzo/
Main installation directory. Contains application code, binaries, and configuration.
/var/simuzo/
Runtime data directory. Contains all variable data.
/var/simuzo/
├── fs/ # Jail filesystem root
├── cgroups/ # cGroup Plans
├── users/ # User data
├── logs/ # Log files
├── conf/ # Runtime config
└── db/ # Database files
/run/simuzo/
Runtime files and temporary data.
/run/simuzo/
├── stats.json # Live statistics
├── ep_stats.json # Entry process stats
├── ep_limits.json # Process monitor user list & limits
├── dbmap # MySQL user mapping
├── simuzo.sock # Socket file
└── *.pid # PID files
Binaries
/usr/local/simuzo/bin/
| File | Purpose |
|---|---|
| simuzofs-cmd | Execute commands in jail |
| simuzofs-init | Initialize jail |
| simuzofs-ld.so | LD_PRELOAD library |
| simuzofs-config-cache | Config cache |
| simuzo-procmon | Process monitor |
| simuzo-load | Privilege escalation |
| pam_simuzofs.so | PAM authentication module |
Configuration Files
/usr/local/simuzo/universal.php
Main configuration file with all global settings.
/usr/local/simuzo/conf/main.conf
Jail filesystem configuration.
JAIL_HOME /var/simuzo/fs
DEBUG_LEVEL 3
Jail Filesystem
/var/simuzo/fs/{username}/
{username}/
├── etc/
│ ├── passwd
│ ├── group
│ └── shadow
├── var/
│ ├── www/
│ ├── mail/
│ └── log/
├── usr/
├── home/
└── tmp/
cGroups
/sys/fs/cgroup/simuzo/
Main cGroup hierarchy for web server resource limits.
/sys/fs/cgroup/simuzo/
├── user1-1000/
│ ├── cpu.max
│ ├── memory.max
│ ├── memory.high
│ ├── io.max
│ └── pids.max
├── user2-1001/
└── ...
/sys/fs/cgroup/simuzo-db/
Database-specific cGroup hierarchy.
/sys/fs/cgroup/simuzo-db/
├── user1-1000/
│ ├── cpu.max
│ ├── memory.max
│ └── pids.max
├── user2-1001/
└── ...
Log Files
/var/simuzo/logs/
| File | Description |
|---|---|
| simuzo.log | Main application log |
| simuzofs.log | Filesystem isolation log |
| audit.jsonl | Audit trail events |
| stats.log | Statistics collection log |
Security
Never change permissions on Simuzo binaries and configuration files unless instructed. Incorrect permissions can compromise security.