Fresh Installation

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

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: Make sure the directories "/[root]", "/core/packages","/core/cache", and "/core/export" are writable. (root will be the actual directory you are installing to.) Make sure "/manager", "/connectors" are writable. If installing advanced, this is unnecessary. Create a blank file "/core/config/config.inc.php" and make it writable. Try downloading the regular Revolution download instead of the advanced. 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:

• New Installation: Choose this if you're wanting to create a fresh install of MODx. Note that this may completely wipe any existing data you have in your database.
• Upgrade Installation: Choose this if you're wanting to upgrade from a prior Revolution installation. Currently Revolution 2.0 does not support upgrading from 0.9.6 sites fully - the database tables will be upgraded; however, the component (snippet/chunk/etc) tags will not be, and you'll have to do that yourself should you choose to upgrade. You'll also need to upgrade any custom snippets/modules/etc you might have.
• Advanced Upgrade Install: Choose this if you're moving the install to a different server, or wanting to change the database information.

Also, this page also asks a few more questions:

• Core Package Has Been Manually Unpacked: Check this if you have manually extracted the core package from the file core/packages/core.transport.zip. This will reduce the time it takes for the installation process on systems that do not allow the PHP time_limit and Apache script execution time settings to be altered.
• Files Are Already In-Place: Check this if you exported MODx from SVN or extracted it from the full MODx package to the server prior to installation.

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.

If when the setup finishes and you run your new site in a browser this error occurs: "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

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

• Upgrading from 0.9.6.*