Skip to content

How to: update ezXSS

Jump to bottom
elyesa edited this page Jul 20, 2025 · 3 revisions

ezXSS offers a straightforward updating process. To update ezXSS to a newer version, all you need to do is update the files in the document root of your site. This can be done by transferring or retrieving updates with git. ezXSS update page will update your database.

Updating ezXSS

1. Update files in document root

If you installed ezXSS using git, you can pull the latest changes from GitHub.

git pull origin master

If you installed ezXSS by transferring the repository files to the document root, just do this again and make sure your .env file stays intact. All other files can and must be replaced.

2. Update database

When all files are successfully transferred, visit your ezXSS website. Your ezXSS should recognize it has been updated and links you to the update link

  • Visit the update link on /manage/update
  • When updating to ezXSS 4.2, some big database changes have been made. The update page will warn you about tables sizes. Make sure you have enough free disk space available for your database before updating if you have a lot of reports.
  • Click the Update button
  • Done!

Database and code mismatch

If you installed ezXSS from master in between releases, it might be possible your database is already flagged as the latest version, but your code is not. If you would then update your code to the latest release and there has been new SQL tables or columns added you might have missed those and get bugs. When dealing with this issue, please check the app/sql/ folder and manually execute the SQL queries that you have missed. Future code will no longer be pushed to master before release if new update queries are added, to prevent this issue in the future.

Clone this wiki locally