If you encounter any issues during the installation of SmartSite CMS, you can contact our support team to assist you.

Check steps below to help resolve common problems.

Installation wizard not starting

• Problem: The installation wizard isn’t displaying and you see a loading issue!
• Solution: It could indicate that the .htaccess file wasn’t uploaded to the root directory. Since this file may be hidden on your system, ensure hidden files are visible, then upload .htaccess to the root directory to resolve the issue.

Server Requirement Issues

• Problem: Errors indicating missing PHP extensions or incompatible PHP versions.
• Solution: Make sure your server meets all minimum requirements, including PHP 8.1+, Apache/Nginx, and the required PHP extensions (OpenSSL, cURL, mbstring, etc.). Contact your hosting provider if you need assistance.

Database Connection Errors

• Problem: Database connection failure during the installation wizard.
• Solution: Verify that your entered the correct `DB_HOST`, `DB_PORT`, `DB_DATABASE`, `DB_USERNAME`, and `DB_PASSWORD`. Ensure your database server is running and accessible.

File Permission Issues

• Problem: Errors when uploading files or saving changes.
• Solution: Ensure appropriate permissions are set for folders like `/core/storage`, `/core/bootstrap/cache`, and `/uploads` (e.g., `755` or `775` permissions). If the issue persists, check your server’s user permissions.

Installation Wizard Redirection

• Problem: Installation wizard reappears even after completing the setup.
• Solution: Double-check the admin URL (e.g., `yourdomain.com/admin`) and ensure you’re using the correct default credentials. If you’ve changed the path, verify the settings in the `/core/.env` file.

Issues Accessing Admin Dashboard

• Problem: Can’t access the admin dashboard after installation.
• Solution: Rename the `/core/storage/_installed` file to `installed` (without the underscore). This will prevent the installation wizard from reopening.

License Activation Issues

• Problem: Problems activating the license.
• Solution: Double-check your purchase code. If you continue experiencing issues, please contact our support team for assistance.

Loading Issue any time

• Problem: The website is showing a loading issue.
• Solution: Check the configuration file at /core/.env. Ensure that there are no unintended line breaks, as these can disrupt the configuration and cause loading problems.

API Not Functioning Correctly

• Problem: Issues with RESTful API functionality.
• Solution: Ensure the API is activated from the System Settings in the dashboard and that your API key is correctly configured.