Fresh Installation


To start installation of MODx Revolution, start your web browser and run the setup script by navigating to the setup/ folder.

Please note this is for installation from the distributions of MODx available from the main download page. Users attempting to install MODx from SVN should see the Using MODx Revolution from SVN page.
You might want to check the Server Requirements page first. Also, do not run Firebug when running MODx Revolution. Firebug is known to slow down JS applications and cause problems.

Advanced download users will note that this is the only directory available. *Do not* unzip core.transport.zip - MODx will do this for you. 

If you get a blank screen, verify these steps:

  1. Make sure the directories "/[root]", "/core/packages","/core/cache", and "/core/export" are writable. (root will be the actual directory you are installing to.)
  2. Make sure "/manager", "/connectors" are writable. If installing advanced, this is unnecessary.
  3. Make sure your php.ini setting sets memory_limit to 128M, and max_execution_time to 120
  4. Create a blank file "/core/config/config.inc.php" and make it writable.
  5. Try downloading the regular Revolution download instead of the advanced.
  6. Post a message in the Revolution forum regarding your issue. State your server setup and installation info, and we'll try and help you find a solution.


From there you will be asked to choose a language and agree to licensing. After this, you'll be presented with some options:

Also, this page also asks a few more questions:

From this point on, the installation proceeds as normal.

It's a good idea to make sure to remove the setup/ directory after installing, to safeguard your site.
When the setup finishes and you run your new site in a browser, if you see this error: "No vaild content type", go to Tools -> Content Types and verify there is a text/html content type. If not, add one.

Installing Packages

For information on installing 3rd-party packages, see the How to Install Packages article.

Additional Info

Some other special cases:

WAMPServer 2.0i

Please see this article: Problems with WAMPServer 2.0i

MAMP on MacOSX

MAMP (including latest 1.8.4) works fine with MODx Revolution, with one exception. You cannot use eAccelerator as the caching system, as the drivers compiled with MAMP are faulty with regards to PDO and will cause Apache kernel errors. Select the 'xCache' caching drivers to remedy this.

Vista and XAMPP

There have been reported problems with installing Revolution on 64-bit Vista with XAMPP. We cannot guarantee a working solution on that OS and setup at this time.

Some users have reported that applying a fix found here:

http://www.apachefriends.org/f/viewtopic.php?f=16&t=32617

will fix Apache crashing errors with PDO support in XAMPP.

See Also


Browse Space

- Pages
- News
- Labels
- Attachments
- Bookmarks
- Mail
- Advanced

Explore Confluence

- Popular Labels
- Notation Guide

Your Account

Log In

Other Features

Add Content