Local Installation Guide
Learn how to install Aikeedo on your local machine for development, testing, or personal use. This guide covers various setup options, including using PHP’s built-in server and popular local development environments.
This guide will walk you through the process of installing Aikeedo on your local machine. This is ideal for development, testing, or personal use.
Prerequisites
Before you begin, ensure you have:
- Downloaded the Aikeedo package
- Familiarity with command-line operations
- A local development environment (we’ll cover different options)
Option 1: Using PHP’s Built-in Server
This option is suitable if you already have PHP and MySQL installed and accessible via the command line.
Prepare Your Environment
Ensure you have:
- PHP 8.2 or higher installed and accessible via command line
- MySQL 8.0 or higher installed and running
Extract Aikeedo Files
- Locate the
aikeedo-server-files.zip
in your Aikeedo package. - Extract the contents to a directory of your choice, e.g.,
C:\aikeedo
or/home/user/aikeedo
.
Set Up the Database
-
Open your MySQL client or command-line tool:
- For command-line users, open your terminal and type
mysql -u root -p
to access MySQL. - For GUI users, open tools like phpMyAdmin, MySQL Workbench, or HeidiSQL.
- For command-line users, open your terminal and type
-
Create a new database for Aikeedo:
- In the MySQL command line or GUI query window, execute the following SQL command:
- This creates a new, empty database named ‘aikeedo’ that will store all your Aikeedo data.
-
Create a new user (recommended for security):
Replace ‘your_secure_password’ with a strong, unique password.
-
Note down the following information for the installation wizard:
- Database name: aikeedo
- Username: aikeedo_user (or ‘root’ if you skipped step 3)
- Password: The password you set (or your root password if using root)
- Host: localhost (in most cases)
If you’re not comfortable with database management, consider using a database administration tool like phpMyAdmin, which often comes pre-installed with local development environments like XAMPP or MAMP.
Start the PHP Server
To start the PHP development server:
- Open your terminal or command prompt.
- Navigate to the root directory of your Aikeedo installation. This is the directory where you extracted the Aikeedo files, e.g.,
C:\aikeedo
or/home/user/aikeedo
. - Once in the root directory, run the following command:
This command does the following:
php -S
starts PHP’s built-in development serverlocalhost:8000
sets the server to listen on localhost at port 8000-t public
sets the document root to thepublic
directory within your Aikeedo installation
After running this command, you should see output indicating that the server is running. Keep this terminal window open to keep the server active.
Access Aikeedo
Open your web browser and navigate to http://localhost:8000
. You should see the Aikeedo installation wizard.
Follow On-Screen Installation Wizard
- Provide the database credentials you noted earlier.
- Enter your Aikeedo Purchase Code.
- Set up your admin account details.
- Follow any additional steps as prompted by the wizard.
Option 2: Using Local Development Environments
This option is suitable if you prefer using pre-configured local development environments like XAMPP, MAMP, or Laragon.
Install XAMPP
Download and install XAMPP from the official website.
Configure Virtual Host
- Open
C:\xampp\apache\conf\extra\httpd-vhosts.conf
(Windows) or/Applications/XAMPP/etc/extra/httpd-vhosts.conf
(macOS). - Add a new virtual host:
Update Hosts File
- Open your hosts file (
C:\Windows\System32\drivers\etc\hosts
on Windows or/etc/hosts
on macOS). - Add the following line:
Extract Aikeedo Files
Extract the contents of aikeedo-server-files.zip
to C:\xampp\htdocs\aikeedo
(Windows) or /Applications/XAMPP/htdocs/aikeedo
(macOS).
Set Up Database
- Open phpMyAdmin (usually at
http://localhost/phpmyadmin
). - Create a new database named
aikeedo
.
Access Aikeedo
Restart Apache in XAMPP, then navigate to http://aikeedo.test
in your browser. You should see the installation wizard.
Complete Installation
Follow the on-screen installation wizard to complete the setup.
Remember, Aikeedo must be installed in the domain root. Subpaths like http://localhost/subdirectory
are not supported.
Troubleshooting
If you encounter any issues during local installation:
- Ensure your local environment meets all server requirements.
- Check that all file permissions are set correctly.
- Verify that your virtual host and hosts file configurations are correct.
- For more detailed troubleshooting steps, refer to our Troubleshooting Guide.
If you’re still having trouble, don’t hesitate to reach out to our support team.
Next Steps
After successfully installing Aikeedo locally:
- Explore the Initial Setup Guide to configure your local instance.
- Check out our Local Development Guide for tips on developing with Aikeedo.
Congratulations on setting up Aikeedo locally! You’re now ready to start developing or testing with your local instance.
Was this page helpful?