Fresh Installation

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

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 that your setup/templates/_compiled directory is writable. If it doesn't exist, create it and make it writable. Make sure the directories "/[root]", "/manager", "/connectors", "/core/packages","/core/cache","/core/export" are writable. (root will be the actual directory you are installing to.) Create a blank file "/core/config/config.inc.php" and make it writable. Try downloading the regular Revolution-alpha 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-alpha 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.
• 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.