MODX Installation FAQ
For general installation instructions, look here.
Before looking at the specific issues below, you might want to check the General MODX Weirdness page.
If you don't find an answer here, ask for help in the appropriate section of the MODX Forums. If they might have a bearing on your problem, be sure to include your browser version, MODX version, hosting service, Apache version, PHP version, and MySQL version.
I get a blank page after the install. What's wrong?
- Installing MODx Revolution over an earlier version
- core/cache directory is not writable
- database password contains a quotation mark or other illegal character
- Permission issue with MODx directories and files
- Not enough memory for proper install (see "out of memory" below)
- Very old version of MySQL or PHP
- Make sure your memory_limit is at least 64M
- Make sure the following directories are writable:
- / (MODx root directory)
- Create an empty file: "/core/config/config.inc.php" and make it writable.
- Use the "Regular" version of Revolution instead of the "Advanced" version.
I get a blank page or an "unable to load page" error when I try to run setup. What's wrong?
;extension=php_json.dllSee also the item below about the timezone warning. Sometimes the timezone warning isn't on the screen long enough to read.
I've upgraded MODx and the Manager is all messed up. What now?
If so, it's likely that it's one of these:
- 1. File and/or directory permissions were changed by the file transfer and MODx can't read or write some necessary files.
- 2. File permissions issues prevented a new file from overwriting an old one.
- 3. One or more files was corrupted during the transfer.
- 4. Trouble with the compress_js System Setting
In the case of #3, log out and edit the modx_system_settings table in PhpMyAdmin. Find compress_js and change the value to 0,then delete the core/cache/system_settings/config.cache.php file and log back in.
I get a blank page for one or more pages on the site. How do I fix that?
- Create an error page that is not the site_start page and set the error_page System Setting to its ID. The error page is where MODx sends users when the page they request is not found.
- Create a proper robots.txt file at the root of your site. Look here for more information.
- Modify the .htaccess file in the site root by uncommenting the code that redirects all visitors to either "www.yourdomain.com" OR "yourdomain.com".
Why do I get this error: Fatal error: Call to undefined function mb_strlen() in [filename]?
If that's not possible, you can try changing mb_strlen() to just strlen() in the file referenced in the error message.
I'm getting a warning about the system's timezone setting. How can I fix it?
Put something like this in your php.ini file:
date.timezone = "America/Chicago"
If you don't have access to php.ini, you can try adding this to your .htaccess file:
php_value date.timezone America/Chicago
If you don't have access to the php.ini file and modifying .htacces gives you an error, you can try putting a line like this in the index.php file in the MODX site root:
If none of these work, you'll need to contact your hosting service.
Note: If you're using XAMPP, you can modify /xampp/apache/bin/php.ini.
I'm getting an error message about PDO or pdo_mysql not being available. What's up with that?
It's hard to give generic advice here on altering php.ini because it depends on your platform, but basically you need to uncomment the line that enables what the error message tells you needs enabling. Uncomment the line by removing the semicolon at the beginning. This is a commmon one:
;extension=php_pdo_mysql.dll ; change it to: extension=php_pdo_mysql.dllThen, restart your server.
If the site is on a remote server, ask your host to enable pdo.
I'm getting an Internal Server 500 error on my MODx install. What do I do?
One common possibility is file permissions. If your host uses suExec or suPHP, the permissions on folders should be 755 and files should be set to 644. Usually this is done by going to cPanel (or the equivalent) at your host and clicking on "File Manager." In File Manager, you navigate to the file or directory you want to change (your site will normally be under public_html). You'll see the permission numbers on the right as you go. When you get to the target file or directory, click on its name, then on "change permissions." An even easier method, if it works on your host, is to use the free FileZilla FTP program which allows you to set permissions for all files and folders recursively.
Another, less common, possibility is a bug in the MODx SearchHighlighting Plugin. Disabling the plugin will solve the problem.
On some hosts, having a php directive in the .htaccess file will generate a Server 500 error.
php_flag zlib.output_compression OnThe solution is to comment out the php_flag lines with a '#' character at the beginning:
#php_flag zlib.output_compression OnHaving an unpublished error document on the MODx site can also cause a 500 error under some circumstances.
Another possiblity is having a "rewrite engine on" statement in an .htaccess file and another .htaccess file in a directory below that one that also contains the same line.
If you get a 500 error when you turn on Friendly URLs with XAMPP on localhost, make sure you have these in your xampp/apache/conf/httpd.conf (without the # comment token at the beginning):
LoadModule rewrite_module modules/mod_rewrite.so AllowOverride AllIf you are getting this error on a site you moved by exporting and importing the SQL, be sure you have enabled DROP TABLE and CREATE TABLE in the export.
I've upgraded MODx Revolution from a much earlier version and I keep ending up back at the login screen. How can I fix that?
I've moved my site to another server. Why can't I install the packages I've downloaded?
I'm getting an "out of memory" message during the install process or I'm seeing weird behavior after the install. What can I do?
Increasing the amount of memory depends on your host. You may be able to add this php directive in your .htaccess file:
php_value memory_limit 128MIf that doesn't work, you may be able to edit or add a php.ini file and change the memory limit:
memory_limit = 128MNote that the server has to be restarted for the changes in memory_limit to take effect. In some cases, you'll have to ask your hosting service to increase your memory limit (or change hosts).
The install ran perfectly, but I can't log into the Manager. I'm positive that my username and password are correct. What now?
Why does checking the database connection fail during install even though I know my credentials are right?
- Be sure to use "localhost" as the database server name. It's almost always correct.
- If MODx has trouble creating the database, you may have to do it yourself. Make sure to create a user and give the user full rights to the database. That user's username and password are what you need for the database connection form during the MODx install — not your MODx username and password.
- Some hosts add a prefix to the database name and/or database username so the names you entered when you created the DB/User may not be the real ones.
- The next best guess here is either a too-old version of PHP, a PHP/MySQL version mismatch, or a misconfigured or disabled PHP or MySQL install.
- Also possible are a non-standard port, or a name other than "localhost" for the database server.
I've installed MODx over an existing non-MODX site, why do I keep seeing either the old site or an index of the root directory instead of my MODx site in the front end?
I've installed MODx Revolution and I get a 404 "Page not Found" error in the front end. Why is this happening?
I've installed MODx Revolution and there is no Rich Text Editor (e.g. TinyMCE). Where is it?
When I go to Package Manager in MODx Revolution, and click on "Download Extras," I get to the repository, but there are no packages listed. Why not?
Go to Reports | System Info and click on the "view" link next to PhpMyAdmin. Find the location of your php.ini file. In a text editor, edit that file and uncomment the following line (remove the leading semicolon):
;extension=php_curl.dllSave the file and then stop and restart Apache.
I've installed MODx Revolution and there are no snippets (e.g. Wayfinder, Ditto, etc.) What's up?
I've installed MODx Revolution and the Components menu is missing. Is this normal?
I have weird behavior in MODx after the install that isn't covered here. What now?
Sometimes, one or more MODx files is corrupted in download or upload. MODx has a lot of files and this happens more often than you might think. If everything else fails, try downloading and installing again.
I can't save some things in the Manager. When I try to save (happens most often with templates and snippets), MODx freaks out. What's wrong?
None of that helped me. What do I do now?
How did you create this marvelous FAQ?
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 BobsGuides.com
— Bob Ray