Skip to content

Latest commit

 

History

History
47 lines (33 loc) · 2.57 KB

tshoot_mod_access_compat.md

File metadata and controls

47 lines (33 loc) · 2.57 KB
group subgroup title menu_title menu_node menu_order redirect_from functional_areas
installation-guide
02_access
503 (Service Unavailable) errors accessing Magento software in a web browser
503 (Service Unavailable) errors accessing Magento software in a web browser
3
/guides/v1.0/install-gde/trouble/tshoot_mod_access_compat.html
/guides/v2.0/install-gde/trouble/tshoot_mod_access_compat.html
Install
System
Setup

503 (Service Unavailable) errors accessing Magento software in a web browser {#trouble-install-depend}

Symptoms

When you try to access your {% glossarytooltip 18b930cf-09cc-47c9-a5e5-905f86c43f81 %}Magento Admin{% endglossarytooltip %} or {% glossarytooltip 1a70d3ac-6bd9-475a-8937-5f80ca785c14 %}storefront{% endglossarytooltip %} in a web browser, you get HTTP 503 (Service Unavailable) errors.

To confirm this issue is not related to [maintenance mode]({{ page.baseurl }}/install-gde/install/cli/install-cli-subcommands.html#instgde-cli-maint-configphp), look in your Apache error.log for messages that include:

"Invalid command 'Order', perhaps misspelled or defined by a module not included in the server configuration". 

Details

Apache 2.4 changes the way certain directives related to .htaccess work. The Magento software uses .htaccess to rewrite URLs. If .htaccess doesn't work properly, you cannot access the Magento software in a web browser.

Not all Apache 2.4 distributions have this issue because in some cases, a compatibility {% glossarytooltip c1e4242b-1f1a-44c3-9d72-1d5b1435e142 %}module{% endglossarytooltip %} named mod_access_compat is enabled by default. If, however, your Apache 2.4 distribution has this module disabled, you must perform the tasks discussed in the next section. You can also consult the resources listed in the final section in this topic.

Suggested solution

As a user with 'root' privileges, enter the following commands:

a2enmod access_compat
service <name> restart

On CentOS, <name> is httpd. On Ubuntu, <name> is apache2.

Additional resources