I can't login to the Admin after installing Zen Cart

Post installation login issues

In most cases of difficulties logging in to the Admin area, the problem is one of:

  1. Admin pages won’t show at all, or show without styling.
    In this case, try temporarily renaming the admin/.htaccess file to htaccess_bak to see if things operate differently.
    If they do, then you need to work with your webhost to find the right way to use the supplied .htaccess security protections on your site.

  2. Something may be wrong with the way your site is configured to handle PHP sessions. This is more difficult to resolve.

    1. Start by clearing your browser cache and clearing all cookies. ** THIS IS THE MOST COMMON PROBLEM **

    2. Make sure you’re not using “Private Browsing” or “Incognito” mode.

    3. Then check to be sure that you do NOT have any software firewall applications running on your PC, as they may have been set to “disable session cookies”.

    4. Also, make sure your browser IS allowed to accept cookies, esp from your own domain. Cookie-blocking will break your Admin area.

    5. Check your server’s errorlog to determine if any errors are occurring at the time of the failure to login.

    6. If you are using www. in your URL on one page and not using www in the URL on another page, you may have problems. This related FAQ may help: how can I force www?

    7. Try the suggestions in this related FAQ article: I can’t stay logged in

  3. Apart from browser cache and cookies problems, the most common problem is not having the https correct in your admin/includes/configure.php  file.
    See: How do I enable SSL?

  4. Try using another browser, turning off browser plugins or logging out of and then back in to your password manager. Sometimes login failures are simply local environmental issues that you need to straighten out.

  5. If you’ve installed your site into a folder whose name contains spaces, rename the folder so that it doesn’t have spaces anymore. Update your configure.php files accordingly.

If all else fails, you may need to reset your admin password via the database. See the FAQ for resetting your admin password.

Still have questions? Use the Search box in the upper right, or try the full list of FAQs. If you can't find it there, head over to the Zen Cart support forum and ask there in the appropriate subforum. In your post, please include your Zen Cart and PHP versions, and a link to your site.

Is there an error or omission on this page? Please post to General Questions on the support forum. Or, if you'd like to open a pull request, just review the guidelines and get started. You can even PR right here.
Last modified August 11, 2021 by Scott C Wilson (63b3dde).