Before You Start
- Ensure your server meets our requirements.
- Prepare a database and note down its name, username, and password.
- Have your Aikeedo purchase code ready.
Understanding the Public Directory
It’s crucial to understand how Aikeedo’s file structure works with your domain:- Aikeedo has a
public
directory that contains web-accessible files. - Your domain should point to this
public
directory, not the root of all Aikeedo files. - The
public
directory cannot be moved; it must remain within the Aikeedo file structure.
- For main domains: copying the contents of the
public
folder to yourpublic_html
directory. - For add-on domains or subdomains: setting the document root to the
public
folder within your Aikeedo installation.
Installation Process
- Main Domain
- Add-on Domain or Subdomain
Follow these steps to install Aikeedo on your main domain in cPanel:
1
Upload the Archive
- Locate the
aikeedo-server-files.zip
archive in your Aikeedo package. - Upload this archive to the directory one level above your
public_html
folder. For example, if yourpublic_html
path is/home/username/public_html
, upload to/home/username/
.
If you can’t find the zip file, refer to our File Structure guide.
2
Extract the Archive
Once uploaded, extract the contents of
aikeedo-server-files.zip
in the same directory.3
Configure the Public Directory
- Find the
public
folder within the extracted files (e.g.,/home/username/public
). - Copy () all contents from this
public
folder to yourpublic_html
directory. - Make sure to include hidden files and folders (such as .htaccess file or .vite directory).
4
Update the Environment File
- Locate the
.env.example
file in your Aikeedo root directory (e.g.,/home/username/
). - Find the line that contains
# PUBLIC_DIR=public_html
. - Uncomment this line by removing the
#
symbol and the space after it. - The final version of this line should look like:
.env.example
- Save the changes to the file.
5
Begin the Installation
- Open your web browser and navigate to your domain.
- You’ll be automatically redirected to the installation page at
/install
.
6
Complete the Setup
- Follow the on-screen instructions in the installation wizard.
- You’ll need to provide:
- Database credentials
- Your Aikeedo purchase code
- Admin account details
- Complete all steps as guided by the wizard.
Important Notes
- Throughout this guide, we use absolute paths (e.g.,
/home/username/
). In cPanel’s file manager, you might not see the/home/username/
part. For example,/home/username/public_html
might appear as just/public_html
. - Always ensure you’re working in the correct directory for your specific domain setup.
- The
public
directory contains all files that should be publicly accessible. Don’t confuse this with cPanel’s defaultpublic_html
directory.
Troubleshooting
If you encounter any issues during the installation process:- Double-check that you’ve followed each step correctly.
- Ensure all file permissions are set correctly.
- Verify that your server meets all the requirements.
- For more detailed troubleshooting steps, please refer to our dedicated Troubleshooting Guide.
Next Steps
After successfully installing Aikeedo:- Follow our Initial Setup Guide to configure your new installation.
- Explore Website Basics to learn about key Aikeedo features.
- Consider setting up email for your Aikeedo instance.