Things to check and try first
If you are having problems with your Tiki, here a number of things that you should review and try first:
- Things to check and try first
- Common Tiki Problems
- Locked out of Tiki
- Won't save certain content
- Blank pages
- Internal server error
- Forgotten admin password
- Session issues
- Broken theme
- Module breaks site
- Missing or corrupted files
- tiki-login.php unable to login
- Lucene Search related issues
- Try another browser
- Try from another computer with http://anonymouse.org/anonwww.html or http://www.downforeveryoneorjustme.com/ (your IP could be blocked or something)
- Use Tiki Check to detect issues.
- Check for BOM in your files
- Check release notes for your version and the previous ones — is this a known issue?.
- Check the reported bugs — is this a reported issue?
- Are you running latest stable version? Your Tiki version is shown on the General Admin page.
- Is database out-of-date? Starting in version 3.0, Tiki will report a Database Version Problem message on the Admin Panels if your database requires an update.
- Is your database corrupt? See Repair database for details.
- Clear all Tiki caches by selecting Admin > Tiki Cache from the menu.
- Deactivate GZIP, Minify, and other options in the Performance admin panel
- Deactivate Apache Clean URLs (especially if you are on Windows IIS server). If this solves the issue, it's likely because you are using an old version of .htaccess instead of the one for your version of Tiki.
- Clear your browser's cache by using Ctrl+F5. Refer to your browser's help system for details.
- Clear your browser's cookies. Refer to your browser's help system for details.
- Try another browser, such as Firefox, Internet Explorer, Safari, Chrome, or Opera.
- Check your web server's error log. Any file or folder permission problems are commonly shown in the log.
- Are your Tiki file and folder perms configured properly? If you have shell access to the server, use sh setup.sh.
- Attempt to log out of your Tiki, then log in again.
- Check integrity of your files.
- Have you added any custom entries to the .htaccess file? Temporarily comment them out.
- If you changed a server setting, did you restart Apache?
- Change the theme (especially if you are using custom theme). See Tiki Themes for details.
- Try to reproduce the problem on a Tiki demo site. If you can reproduce, then, please report a bug.
- Enable the Tiki debugging features by applying the Debug Mode Profile.
- Check in MySQL for the table tiki_actionlog to see what the latest changes were before the issue started.
Common Tiki ProblemsBe sure to review the Tiki FAQs for answers to frequently asked questions.
Locked out of Tiki...and I can't go to profiles to enable Debug Mode
- Run the installer at tiki-install.php
- In one of the steps, you can activate error messages
- Access your database (by using Adminer, phpMyAdmin or the equivalent).
- Find the table
- Edit the values from above.
- Item: error_reporting_level
- Value: 2047
You should also empty the Tiki cache or manually delete all *.tpl files in the ../templates_c/ directory.
Please note that some server configurations will prevent Tiki from overriding the error reporting of PHP. Make sure your server has error reporting and/or logging properly setup.
Won't save certain contentThis could be because of ModSecurity, which you should turn off temporarily.
Blank pagesThe most common cause of a blank screen in which Tiki shows no error message and no content is insufficient PHP script execution memory. Tiki requires minimum of 32MB (the default value of PHP 5.3 is 128 Megs and ideally, it should be at this value). (which you can change in php.ini or httpd.conf. If you are using APC, XCache or eAccelerator, make sure they also have enough memory.
Also make sure to activate your error messages. You can do this be re-running the installer at tiki-install.php (Step #7 Configure the General Settings)
Review your tiki-phpinfo.php page or contact your server admin to make sure your site meets this requirement. See Requirements for details.
Blank pages after inserting codeOther case of getting WSOD (or a "blank page") can happen when you insert some custom JS or CSS code containing curly brackets in the Look & Feel admin panel or custom module textareas and forgot to surround them with literal Smarty block:
Lets assume, that you cut and pasted some code containing curly brackets in the Custom HTML Head textarea.
Now you hit the Apply button and suddenly.. Eeek! You are "locked out" in the WSOD! But Do not panic™! There is a solution ;)
Actually you have two options how to fix or reset it back:
- If you do not want to loose the previous content of that textarea you just edited you can go to your MySQL admin tool (Adminer, PHPMyAdmin or whatever is available for you) and locate the feature_custom_html_head_content field (if it happened to be another textarea than Custom HTML Head, just look for the other one by similar name) in the tiki-preferences table. Then just edit the content of the field to fix it (e.g. by surrounding it by the literal block).
- If you do not care about clearing and resetting that textarea completely, you can just use the following trick. In your browser's address bar instead of the tiki-admin.php?page=look put this there:
Then hit Enter key on your keyboard and your Tiki should be back!
Internal server errorThis can happen because of incorrect File and Folder permissions.
Forgotten admin passwordIf you have lost or forgotten your Tiki admin password, see
Lost admin password.
Session issuesYour Tiki may have trouble writing HTTP sessions to the disk. Instead, try storing in the database. In your lib/prefs/session.php file (you can see an example here, find the session_storage preference and change the 'default' from 'default' to 'db'.
Broken themeIf you customized a Tiki theme and now have problems, see Template Tricks on Tiki Themes.
Module breaks siteIf you created or edited a module and included invalid or poorly formatted syntax, Tiki may display errors. Access your database (for example, by using Adminer or phpMyAdmin) and remove the offending module from the tiki_modules table. Please note that you can easily re-instate via the admin panel after, as it is not deleted but just unassigned.
Missing or corrupted filesIf you are getting weird error messages that no one else seems to be getting, it could that your upload didn't complete properly. So you are missing some files or they are corrupt. The solution is simple: reupload the files. Check file integrity
tiki-login.php unable to login
- Here is the error msg: XMLRPC Error: 5 - Didn't receive 200 OK from remote server. (HTTP/1.0 301 Found)
- This happens with tiki.org is not available (with InterTiki login)