WordPress Site 404 Post-Installation
If you receive a 404 Not Found error immediately after installing WordPress—specifically when attempting to use the Single Sign-On (SSO) feature—it is likely due to the web server's handling of permalink rules.
The OpenLiteSpeed Behavior
WordPress SSO relies on the .htaccess file to route requests correctly. Unlike Apache, OpenLiteSpeed (OLS) does not automatically reload .htaccess files when they are created or modified. This means the new WordPress rewrite rules aren't active until the server process is restarted.
How to Resolve:
- Confirm if your server is running the OpenLiteSpeed role.
- Access the server via SSH.
- Run the following command to restart the container and force a reload of all rewrite rules:
docker restart openlitespeed
If you are utilizing this server for mass hosting, we strongly recommend switching to Apache or Commercial LiteSpeed. Both of these servers handle .htaccess changes dynamically, preventing the confusion and manual restarts associated with OpenLiteSpeed.