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/

FilePurpose
simuzofs-cmdExecute commands in jail
simuzofs-initInitialize jail
simuzofs-ld.soLD_PRELOAD library
simuzofs-config-cacheConfig cache
simuzo-procmonProcess monitor
simuzo-loadPrivilege escalation
pam_simuzofs.soPAM 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/

FileDescription
simuzo.logMain application log
simuzofs.logFilesystem isolation log
audit.jsonlAudit trail events
stats.logStatistics collection log
Security Never change permissions on Simuzo binaries and configuration files unless instructed. Incorrect permissions can compromise security.