This page helps you troubleshoot common problems encountered in DokuWiki. If you're experiencing any issue not covered here, check the DokuWiki support forum or community for more help.

• Issue:*

The page might not load, showing a blank screen or server error.

• Possible Causes:*
  1. Server misconfiguration.
  2. Corrupted DokuWiki files.
  3. Permissions issue.

• Solutions:*
  1. *Check Server Logs:*

Examine the web server logs (e.g., Apache or Nginx) to see if there are any errors. Check for permissions issues or missing files.

1. *Permissions Check:*

Ensure the correct file and folder permissions are set, particularly the data/ , conf/ , and lib/ folders. Permissions should be set to 755 for directories and 644 for files.

    
    Example command to set the correct permissions:
    <code>chmod -R 755 data/ conf/ lib/</code>
    <code>chmod -R 644 data/pages/* data/media/*</code>
    
  - *Reinstall DokuWiki Files:*  
    If a file has become corrupted, consider re-uploading or reinstalling DokuWiki files.

• Issue:*

When trying to access the page, you encounter a 403 Forbidden error.

• Possible Causes:*
  1. Incorrect file or directory permissions.
  2. Incorrect `.htaccess` or server configuration.
  3. Restrictive user roles or access permissions within DokuWiki.

• Solutions:*
  1. *Check .htaccess File:*

Ensure there are no restrictions preventing access in the `.htaccess` file. If unsure, try renaming it temporarily to see if access is restored.

    
  - *File Permissions:*  
    Ensure that the DokuWiki folders have correct permissions (refer to the solution in Section 1).

1. *Review DokuWiki Access Control List (ACL):*

Review the acl.txt file in the conf/ directory and ensure that the permissions are set correctly for the users or groups attempting to access the page.

    Example ACL rule to allow public access:
    <code>*   @ALL   1</code>

• Issue:*

You can't upload media files to your DokuWiki site, or you get an error message when uploading.

• Possible Causes:*
  1. Incorrect file permissions.
  2. File size limit restrictions.
  3. File type not allowed.

• Solutions:*
  1. *File Permissions:*

Check that the data/media/ folder has write permissions.

    
    Example command to ensure the correct permissions:
    <code>chmod -R 755 data/media/</code>

1. *File Size Limit:*

Check the PHP configuration (php.ini) for upload limits. Look for the following directives and adjust them if necessary:

    <code>upload_max_filesize = 10M</code>
    <code>post_max_size = 10M</code>

1. *Allowed File Types:*

DokuWiki may block certain file types for security reasons. Check the file types in conf/mime.conf and ensure the file type you're trying to upload is permitted.

• Issue:*

Search functionality is returning no results or not working properly.

• Possible Causes:*
  1. Corrupted search index.
  2. Missing files or outdated cache.

• Solutions:*
  1. *Rebuild Search Index:*

You can rebuild the search index from the DokuWiki Admin page by navigating to Admin > Indexing and selecting Rebuild Search Index.

1. *Clear Cache:*

If the search results seem outdated, try clearing the cache. Delete the contents of the data/cache/ directory, but not the directory itself.

    
    Example command to clear the cache:
    <code>rm -rf data/cache/*</code>

• Issue:*

A plugin installed in DokuWiki is not working as expected.

• Possible Causes:*
  1. Plugin not activated.
  2. Plugin is incompatible with your DokuWiki version.
  3. Incorrect installation or missing files.

• Solutions:*
  1. *Check Plugin Compatibility:*

Ensure the plugin is compatible with your version of DokuWiki. Visit the plugin’s page on the DokuWiki plugin repository for version compatibility information.

    
  - *Activate Plugin:*  
    Go to the ''Admin > Extension Manager'' page and make sure the plugin is activated.

1. *Reinstall Plugin:*

If the plugin is still not working, try reinstalling it by deleting the plugin folder and uploading it again from the plugin repository.

• Issue:*

You cannot access the Admin panel of DokuWiki, or you see an error when trying to open it.

• Possible Causes:*
  1. Incorrect permissions for the conf/ or data/ directories.
  2. Corrupted session files.
  3. Admin user permissions.

• Solutions:*
  1. *Clear Session Files:*

Delete old session files located in the data/cache/sessions/ directory. Example command:

    <code>rm -rf data/cache/sessions/*</code>

1. *Check User Permissions:*

Ensure the admin user has the correct ACL permissions in the acl.txt file. Example entry for an admin user:

    <code>user:admin    @ALL   8</code>

1. *File Permissions:*

Double-check that the DokuWiki installation files have proper permissions (similar to the solution provided in Section 1).

• Issue:*

The DokuWiki theme is not displaying correctly, or you see broken styles on the page.

• Possible Causes:*
  1. CSS or theme files are missing or corrupted.
  2. Theme incompatibility with the DokuWiki version.

• Solutions:*
  1. *Check Theme Files:*

Ensure the theme files are present in the lib/tpl/ directory