Installing the MODX CMS

Installing MODX is relatively easy. If you have a localhost setup on your home computer (with XAMPP, for example), you can install MODX there fairly quickly.

The process is simple and a good step-by-step set of instructions for installing MODX Evolution can be found here. The notes below are mainly for MODX Evolution, though most apply to MODX Revolution as well. If you are installing MODX Revolution, look here. I've also written a three-part series of blog posts on installing MODX with much more detailed information on My Blog.

Once the database is set up, the files are uploaded, and you've created the manager/includes/ file as directed in the instructions, you simply point your browser to and follow the instructions. Select a good strong password which includes both letters and numbers and don't use any words found in a dictionary. Be sure to enter it carefully and write it down!.

If you are installing MODX for the first time, it's a good idea to install the sample web site. It uses most of the main MODX snippets and a working blog. You can examine it (and modify it) to see how everything works.

When you're finished and the site is working. Be sure to make the file read-only so would-be miscreants can't alter your site. You'll also want to remove the install directory if you didn't tell MODX to do so during the install. You can always re-upload it later if you need to re-install.

When the install is finished, you access the manager by pointing your browser to The default user name is admin but, for security, you should remember to change it to something else.

For some troubleshooting information, check out the Installation FAQ here.


My book, MODX: The Official Guide - Digital Edition is now available here. The paper version of the book is available from Amazon.

If you have the book and would like to download the code, you can find it here.

If you have the book and would like to see the updates and corrections page, you can find it here.

MODX: The Official Guide is 772 pages long and goes far beyond this web site in explaining beginning and advanced MODX techniques. It includes detailed information on:

  • Installing MODX
  • How MODX Works
  • Working with MODX resources and Elements
  • Using Git with MODX
  • Using common MODX add-on components like SPForm, Login, getResources, and FormIt
  • MODX security Permissions
  • Customizing the MODX Manager
  • Using Form Customization
  • Creating Transport Packages
  • MODX and xPDO object methods
  • MODX System Events
  • Using PHP with MODX

Go here for more information about the book.

Thank you for visiting

  —  Bob Ray