Support

Admin Tools

#43023 500 error adding secure htaccess

Posted in ‘Admin Tools for Joomla!’
This is a public ticket

Everybody will be able to see its contents. Do not include usernames, passwords or any other sensitive information.

Environment Information

Joomla! version
5.4.6, 6.1.1
PHP version
8.3/8.4
Admin Tools version
Latest

Latest post by nicholas on Monday, 15 June 2026 00:53 CDT

umbrella
Every time I try to add a secure htaccess with Admin Tools, I get a 500 error front end and backend.

Any ideas? This is on a clean install of admin tools, default settings.

Thanks.

FYI - search isn’t working on forum.

nicholas
Akeeba Staff
Manager

Every time I try to add a secure htaccess with Admin Tools, I get a 500 error front end and backend.

The .htaccess generated by Admin Tools’ .htaccess Maker includes several directives that some servers do not allow in .htaccess files. The safest way to find what your server supports is to start from scratch and enable options one at a time.

Step 0 — Preserve your PHP version directive (important for InMotion)

Before making any changes, open your current .htaccess file (in the root of your Joomla site) and look for a line that sets the PHP handler, such as:

AddHandler application/x-httpd-ea-php83 .php

or similar. Copy that line somewhere safe — you will need to paste it into the Custom .htaccess rules at the bottom field in the .htaccess Maker so it is preserved in every generated file. Without it, InMotion’s server will not know which PHP version to use for your site.

Step 1 — Disable everything and get a clean baseline

  1. Go to Components → Admin Tools → .htaccess Maker.
  2. Set every option to its most permissive or disabled value (the goal is a minimal .htaccess). Pay particular attention to:
    • Follow symlinks → set to Default (this is the most common cause of 500 errors on strict servers)
    • Directory listingsDefault
    • All security header options → disabled
  3. Paste your PHP handler line into the Custom .htaccess rules at the bottom field.
  4. Click Save and Create .htaccess.

If your site now works, you have a clean baseline identical to Joomla’s default htaccess.txt.

Step 2 — Re-enable options one at a time

Enable one option, click Save and Create .htaccess, and test your site. Repeat for each option you want to use. When a particular option causes a 500 error:

  • Rename .htaccess to something temporary (e.g. htaccess-broken.txt) and rename .htaccess.admintools (the backup Admin Tools keeps) back to.htaccess to restore access.
  • Leave that option disabled; it is not supported by your server configuration.

The two most common culprits on dedicated servers are the Follow symlinks option (requires AllowOverride Options in the Apache virtual host) and the security headers (require Apache’s mod_headers). Since you are on an InMotion dedicated server, you may be able to ask their support to add AllowOverride Options and enablemod_headers in your virtual host configuration, which would let you use those features.

FYI - search isn’t working on forum.

We have not had a forum since June 2011, fifteen years ago. We do have a support ticket system. The difference between a forum and a ticket system is the same as between taking a bus and hiring a taxi.

The ticket support system does not have search of its own. It's the same search button at the top right of the page which takes you to DuckDuckGo with a custom site search query (site:akeeba.com). I would be very surprised if DuckDuckGo wasn't working when you were trying to use it.

Nicholas K. Dionysopoulos

Lead Developer and Director

🇬🇷Greek: native 🇬🇧English: excellent 🇫🇷French: basic • 🕐 My time zone is Europe / Athens
Please keep in mind my timezone and cultural differences when reading my replies. Thank you!

Support Information

Working hours: We are open Monday to Friday, 9am to 7pm Cyprus timezone (EET / EEST). Support is provided by the same developers writing the software, all of which live in Europe. You can still file tickets outside of our working hours, but we cannot respond to them until we're back at the office.

Support policy: We would like to kindly inform you that when using our support you have already agreed to the Support Policy which is part of our Terms of Service. Thank you for your understanding and for helping us help you!