Skip to Content

Configuration and error log files to check for troubleshooting

The Ezeelogin configuration file is located at /usr/local/etc/ezlogin/ez.conf

Ezeelogin has two logs files one for the web interface and one for the backend ssh interface called the ezsh shell (short for the Ezeelogin backend shell)


  • The frontend or the web interface runs on PHP and hence a separate log file for it. The log files are stored in the /{system folder specified at the time of installation.
  • You can find the path by checking the system_folder in /usr/local/etc/ezlogin/ez.conf. The path would be /{system folder}/application/logs/
  • You can also run the following command on the Ezeelogin gateway server to get the path to application logs:

root@jumpserver:~  cd $(awk '/^system_folder/ {print $2}' /usr/local/etc/ezlogin/ez.conf)/application/logs/



  • The backend or ssh error logs for each Ezeelogin user are stored in /home/{username}/ezsh.log file. If you are having any issues with the ssh logins, this is the log file to take a look. 
  • You should also check the /var/log/secure & /var/log/messages log file as it records most of the ssh login errors.

    For detailed debug log for troubleshooting, do append the parameter log_level trace in ez.conf 

    root@jumpserver:~  vi /usr/local/etc/ezlogin/ez.conf

    log_level trace

    NOTE  "log_level trace parameter will only work from Ezeelogin version 7.23.0"