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:
|
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. |
| 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. |
