MODx Installation FAQ
For general installation instructions, look here.
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.
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 this line in the index.php file in the MODX site root:
date_default_timezone_set('America/Chicago');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 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.
Example:
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'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 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?
DirectoryIndex index.php
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?
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 empty. 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?
I get a blank page when I try to run setup. What's wrong?
I get a blank page after the install. What's wrong?
- Installing MODx Revolution over an earlier version
- core/cache directory is not writable
- Permission issue with MODx directories and files
- Not enough memory for proper install (see "out of memory" above)
- 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)
- /core/packages
- core/cache
- core/export
- /manager
- /connectors
- Create an empty file: "/core/config/config.inc.php" and make it writable.
- Use the "Regular" version of Revolution instead of the "Advanced" version.
How did you create this marvelous FAQ?
Thank you for visiting BobsGuides.com
— Bob Ray
