Upgrade MODX from within the MODX Manager

Creator: Bob Ray (bobray)

2.1.3-pl (790 KB) Other Versions Need help installing this extra?

About UpgradeMODX

Important: Always back up your site before upgrading.

UpgradeMODX installs a dashboard widget that alerts you when there is an upgrade to MODX available -- and installs it for you!.

When there is an upgrade available, UpgradeMODX will show an "Upgrade MODX" button and a form containing MODX versions. The recommended version to upgrade to should be selected automatically.

When Setup is finished, you'll be back in the Manager using a new version.

UpgradeMODX should work on any installation of MODX except the SDK version. That includes versions with renamed and/or moved directories.

The minimum version listed below is a guess, but for very old versions or MODX that do not support widgets, UpgradeMODX will install an UpgradeMODX resource which you can view to run UpgradeMODX. Once you reach a version that supports widgets, you can reinstall UpgradeMODX and use its Dashboard widget to upgrade.


March 12, 2021
Supported Versions
2.0 – Current
Supported Database
MySQL, Microsoft SQL Server

New in UpgradeMODX 2.1.3

UpgradeMODX 2.1.3-pl

  • Unlock setup directory before running setup
  • Add acceptance tests
  • Fix typo in lexicon string
  • Add id attribute to checkboxes
  • Prevent JS error when MODX is up to date
  • Use local argument for cert path
  • Improve error messages
  • Add Russian translation
  • Improve docs

UpgradeMODX 2.1.2-pl

  • Fix bug causing inactive submit button
  • Fix bug with getting latestVersion value
  • Only update versionlist when necessary
  • Eliminate unnecessary trip to GitHub
  • Provide workaround for versionlist issues
  • Add many unit tests
  • Get true cache path from CacheManager
  • Catch potential uncaught exception in copyFiles processor
  • Cache versionlist for better performance
  • Fix path bug in resolver
  • Better error reporting from GitHub
  • Add ugm_verbose setting for more detailed exception messages
  • Update Swedish translation

UpgradeMODX 2.1.0-pl

  • Fix bug causing inactive submit button- Add option to cache .zip file for use with multiple sites

UpgradeMODX 2.0.3-pl

  • Fix bug with possible 500 error in PHP 5
  • Fix bug with test for copying processors files
  • Update Unit Tests

UpgradeMODX 2.0.2-pl

  • Tell Setup where the core is, so it doesn't ask
  • Automatically select appropriate upgrade version
  • Automatically extend version list to include current version
  • Indicate current version in version list
  • Report progress during upgrade process
  • 3D animation for progress (except on f@$@|#% IE < Edge)
  • Use processors for each step to avoid timeouts
  • Operate entirely in the Manager until setup is launched
  • Add lexicon strings for all text
  • Restyle for Mobile
  • Change Ajax method to get to conform with the HTML 2.0 spec
  • Fix bug with missing versionlist error
  • Make sure downloaded file is closed
  • Get MODX files directly from AWS
  • Update credits
  • Other bug fixes and improvements

UpgradeMODX 1.5.5-pl

  • Fix issue with MODX logo (thanks to DigitalPenguin)
  • Make background image local

UpgradeMODX 1.5.4-pl

  • Fix open_base_dir redirect issue (thanks to Jako)
  • Add Italian translation (thanks to FerX)
  • Update Swedish translation (thanks to Kristoffer Karlström)
  • Fix lexicon->load issue (thanks to sebastian-marinescu)
  • Hide inactive MODX version 2.5.3
  • Change name of temp directory to ugmtemp
  • Delete any created files if there is an error
  • Minor bug fixes and improvements

UpgradeMODX 1.5.3

  • Fix bug with strip_tags and failure to get version list from GitHub
  • Add error message on failure to get version list from GitHub
  • Code cleanup

UpgradeMODX 1.5.2-pl

  • Correct issue with malformed URL (thanks to Jako)
  • Mods for MODX cloud and similar platforms

UpgradeMODX 1.5.1-pl

  • Correct snippet tag in resource
  • Add Swedish translation (thanks to kristk)
  • Fix issue with open_basedir check (thanks to Jako)
  • Fix protocol for loading fonts and logo (thanks to inreti)
  • Add support for local certs for SSL_VERIFY_PEER
  • Fix bug with quit function
  • Add github_username and github_token properties
  • Improve diagnostics

UpgradeMODX 1.4.0-pl

  • Log Upgrades to Manager Actions log
  • Add snippet property to control cURL SSL_VERIFY_PEER option

UpgradeMODX 1.4.0-pl

  • Add forceFopen, githubTimeout, modxTimeout properties
  • Add attempts, and versionListPath properties
  • Improve error handling and diagnostics
  • Unit tests for all methods
  • Refactor for better dependency injection and reliability
  • Fix bug with missing version list

UpgradeMODX 1.3.0-pl

  • Fix bug with blank screen when both cURL and allow_url_fopen are disabled
  • Fix bug in test for cURL
  • Refactor unZip code
  • Add forcePclZip property
  • Improve error handling

UpgradeMODX 1.2.2-pl

  • Public Launch

UpgradeMODX 1.2.1.rc

  • Fix issue with version list
  • wrap class in if (class_exists)

UpgradeMODX 1.2.0-rc

  • Use PclZip if ZipArchive is not available
  • Improve reliability of ZipArchive extraction
  • Fix bug with sorting when plOnly is false
  • Fix bug with missing setup directory
  • Add set_time_limit(0) in loop
  • Fix spurious error in resolver
  • Form and doc updates

UpgradeMODX 1.0.2-beta1

  • Fixed bug with earlier versions of PHP

UpgradeMODX 1.0.0-beta1

  • Initial Version

Current Releases

March 22, 2021
2.0 – Current
March 20, 2021
2.0 – Current
March 12, 2021
2.0 – Current
December 16, 2018
2.0 – Current
View Deprecated Releases

More from Bob Ray



Captcha plugin for MODX Revolution



Refresh the cache for all published resources



Edit Resources in the front end



Create meta tags from TV, Resource description or content field