Installation Troubleshooting
Resolve common issues encountered during the Aikeedo installation process with our comprehensive troubleshooting guide.
If you’re experiencing difficulties during the Aikeedo installation process, this guide will help you identify and resolve common issues. We’ll cover various problems you might encounter and provide step-by-step solutions.
Before You Begin
Before diving into specific issues, ensure that:
- Your server meets all the requirements for Aikeedo.
- You have the latest version of Aikeedo files.
- You’ve carefully followed the steps in our main installation guide.
Common Issues and Solutions
404 Error at /install or 403 Error at Home Page
404 Error at /install or 403 Error at Home Page
If you encounter these errors:
-
Verify Document Root: Ensure your domain’s document root points to the
public
folder within the Aikeedo directory.- For main domains in cPanel: This should be the
public_html
directory. - For add-on domains or subdomains: Update the document root in cPanel to point to the
public
folder.
- For main domains in cPanel: This should be the
-
Check File Extraction: Confirm that all Aikeedo files are extracted correctly and in the right location.
-
File Permissions: Verify that the web server has appropriate permissions:
- Read access to all files
- Execute access to directories You can set permissions using these commands:
-
Hidden Files: Ensure the
.htaccess
file is present in thepublic
directory.
If issues persist, double-check your web server configuration and consult your hosting provider’s documentation.
Database Connection Issues
Database Connection Issues
If you can’t connect to the database during installation:
-
Verify Credentials: Double-check your database credentials:
- Database name
- Username
- Password
- Host (usually ‘localhost’ for most setups)
-
Database Server: Ensure the database server is running and accessible from your web server.
-
User Permissions: Verify that the database user has the necessary permissions:
- SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER
-
Database Existence: Confirm that the specified database exists and is empty.
-
PHP Extensions: Check that required PHP database extensions (e.g.,
mysqli
for MySQL) are installed and enabled.
If problems continue, try creating a new database and user, or consult your hosting provider’s database management tools.
500 Internal Server Error
500 Internal Server Error
If you encounter a 500 Internal Server Error before or after installation:
-
Error Logs: Check your server’s error logs for specific error messages. Common locations:
- Apache:
/var/log/apache2/error.log
or/var/log/httpd/error_log
- Nginx:
/var/log/nginx/error.log
- Apache:
-
PHP Version: Verify PHP version compatibility and ensure all required PHP extensions are installed.
-
Folder Permissions: Set correct ownership and permissions:
-
PHP-FPM: If using PHP-FPM, try restarting the service:
(Replace 8.2 with your PHP version)
-
.htaccess: Ensure the
.htaccess
file in thepublic
directory has the correct settings. -
PHP Memory Limit: Check if PHP has enough allocated memory. You can increase it in
php.ini
:
If the issue persists, enable PHP error reporting temporarily to get more detailed error messages.
Installation Wizard Not Loading
Installation Wizard Not Loading
If the installation wizard doesn’t load or you see a blank page:
-
PHP Errors: Check PHP error logs for any fatal errors or warnings.
-
Browser Cache: Clear your browser cache and cookies, then try again.
-
SSL/HTTPS: If you’re using HTTPS, ensure your SSL certificate is valid and properly installed.
-
File Permissions: Verify that the web server can read all necessary files, especially in the
public
directory. -
PHP Extensions: Confirm all required PHP extensions are installed and enabled.
-
Server Resources: Check if your server has sufficient resources (CPU, RAM) to run the application.
If problems persist, try accessing the site from a different browser or device to rule out client-side issues.
Additional Troubleshooting Steps
If you’re still experiencing issues after trying the solutions above:
-
Fresh Installation: Consider starting with a fresh installation, ensuring you’re using the latest Aikeedo files.
-
Server Configuration: Review your web server configuration (Apache, Nginx) to ensure it’s set up correctly for PHP applications.
-
PHP Configuration: Check your
php.ini
file for any settings that might be causing issues (e.g.,max_execution_time
,upload_max_filesize
). -
Hosting Environment: If you’re on shared hosting, contact your hosting provider to ensure there are no restrictions or issues on their end.
Getting Further Help
If you’ve tried all the above solutions and are still facing issues:
-
Gather all relevant information:
- Exact error messages
- Server specifications
- PHP version and installed extensions
- Steps to reproduce the issue
-
Check our community forums for similar issues and solutions.
-
If you can’t find a solution, don’t hesitate to contact our support team with the gathered information.
Remember, most installation issues can be resolved by carefully reviewing each step of the installation process and ensuring all requirements are met. With patience and attention to detail, you’ll have Aikeedo running smoothly in no time!