Installation Guide

Follow these steps to set up Eventiq on your server. Ensure your environment meets the Laravel 12 requirements before starting.

Quick Start for All Platforms

Use the steps below based on where you want to run the project.

Run on Local Computer

Use this for Windows, Linux, or macOS local development.

1. Extract the project files on your computer.
2. Open terminal in the project root.
3. Run composer install --no-dev --optimize-autoloader.
4. Copy .env.example to .env.
5. Run php artisan key:generate.
6. Create a MySQL database and update database credentials in .env.
7. Run php artisan optimize:clear.
8. Start the project with php artisan serve or create a local virtual host that points to the public folder.
9. Open the local URL in your browser and finish the installer.

Run on Live Server

Use this for VPS, dedicated server, cPanel, or shared hosting.

1. Upload and extract the project files on the server.
2. Point your domain or subdomain document root to the public folder.
3. Run composer install --no-dev --optimize-autoloader in the project root.
4. Copy .env.example to .env.
5. Run php artisan key:generate.
6. Create a MySQL database and update database credentials in .env.
7. Make storage and bootstrap/cache writable.
8. Run php artisan optimize:clear.
9. Open your-domain.com/installer/install in the browser and finish the setup wizard.

Install Dependencies

Run Composer from the project root after upload or extraction:

composer install --no-dev --optimize-autoloader

If your hosting provider does not offer SSH or terminal access, ask them to run Composer for you before starting the installer.

How to Install Composer

Composer is required because the final package does not include the vendor folder.

Windows

1. Install PHP 8.2 or later if it is not already available in your local or server stack.
2. Download Composer-Setup.exe from https://getcomposer.org/download/.
3. Select your PHP executable when the installer asks for it.
4. Allow the installer to add Composer to your system PATH.
5. Finish the installation and reopen PowerShell or Command Prompt.
6. Verify Composer by running composer --version.

Linux

1. Install PHP, curl, zip, and unzip.
2. Download the installer:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

3. Run the installer:

php composer-setup.php

4. Move Composer to a global path:

sudo mv composer.phar /usr/local/bin/composer

5. Remove the installer file:

php -r "unlink('composer-setup.php');"

6. Verify Composer by running composer --version.

macOS

1. Install PHP if it is not already installed.
2. Download the installer:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

3. Run the installer:

php composer-setup.php

4. Create the global binary directory if needed:

mkdir -p /usr/local/bin

5. Move Composer to a global path:

mv composer.phar /usr/local/bin/composer

6. Remove the installer file:

php -r "unlink('composer-setup.php');"

7. Verify Composer by running composer --version.

Shared Hosting

• If SSH access is available, install Composer in your account or use the server's global Composer command.
• If SSH access is not available, ask the hosting provider to run Composer for you.
• Many hosting providers already have Composer installed globally.

If composer Command Is Not Found

• Try php composer.phar --version if Composer was installed locally.
• On Linux or macOS, confirm /usr/local/bin is available in your PATH.
• On Windows, reopen the terminal after installation so the updated PATH is loaded.

Folder Permissions (Linux / VPS)

Before running the installer, ensure these folders are writable:

• storage/
• bootstrap/cache/

Example commands:

chmod -R 775 storage
chmod -R 775 bootstrap/cache

Shared hosting: If you cannot use SSH, set folder permission to 755/775 from your file manager. If permission issues persist, contact your hosting provider.

.env Setup & App Key Generation

If your package does not include a .env file, you must create it from the default example before opening the application.

1. Go to your project root where the Laravel files are extracted.
2. Make a copy of .env.example and rename the new file to .env.
3. Open the .env file and update your application URL and database credentials.
4. Generate the Laravel application key so the APP_KEY value is written automatically.

Required commands: Run these two commands in your project root:

cp .env.example .env
php artisan key:generate

Windows PowerShell:

Copy-Item .env.example .env
php artisan key:generate

Recommended values inside .env:

APP_NAME="Eventiq"
APP_ENV=production
APP_URL=https://yourdomain.com
APP_KEY=base64:generated_app_key_here
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_database_user
DB_PASSWORD=your_database_password
SESSION_DRIVER=file
QUEUE_CONNECTION=database

Deployment Methods

Choose the environment that matches your hosting provider:

Magic Installer (Fast) cPanel Hostinger (hPanel)

Using the Eventiq Web Installer

1. Upload the Eventiq.zip file to your domain's root directory.
2. Extract the files.
3. Open terminal or SSH in the project root and run composer install --no-dev --optimize-autoloader.
4. If the .env file does not exist, create it from .env.example.
5. Visit yourdomain.com in your browser or open /installer/install directly.
6. The wizard will check your server permissions and database connection.

Step 1: Welcome Screen

Step 2: Extension Installation

Step 3: Permission Check

Step 4: Configuration for application

Step 5: Admin Setup

Standard cPanel Installation for Eventiq

1. Open File Manager: Log in to your cPanel. Under the Files section, click on File Manager.
   
2. Navigate to Root: Locate and double-click the public_html folder. This is the directory where your website files must be placed.
   
3. Upload Project: Click the Upload button in the top menu. Select the eventiq.zip file from your computer and wait for the progress bar to turn green.
   
4. Extract Files: Right-click on the uploaded eventiq.zip and select Extract. Ensure the destination is /public_html.
   
5. Create Database: Go back to cPanel Home and click MySQL Database Wizard.
   • Step 1: Name your database (e.g., orfactor_event).
   • Step 2: Create a user and a strong password.
   
6. Assign Privileges: On the final step of the wizard, check the ALL PRIVILEGES box and click "Make Changes".
   
7. Domain & Environment: Point your domain to the /public folder via the Domains setting in cPanel. Run composer install --no-dev --optimize-autoloader in the project root first. If .env is missing, copy .env.example to .env, then update the database name, user, password, and APP_URL. After that, run php artisan key:generate once to create the application key.

Hostinger hPanel Setup for Eventiq

1. Access File Manager: Log in to your Hostinger dashboard. Locate the Files section and click on File Manager.
   
   
   
2. Select Domain Directory: Navigate to domains/yourdomain.com/public_html. Ensure you are in the correct root directory before uploading.
   
3. Upload Source Code: Click the Upload button (arrow icon). Select eventiq.zip from your local machine and wait for the upload to complete.
   
4. Extract the Project: Right-click the eventiq.zip file and select Extract. Choose the current directory as the destination to ensure files are placed in public_html.
   
5. PHP Version Setup: Go to Advanced -> PHP Configuration. Ensure your version is set to PHP 8.2 or 8.3 to meet the system requirements.
6. Create MySQL Database: Navigate to Databases -> MySQL Databases. Enter your database name, username, and a strong password. Click Create.
   
7. Configure .env File: First run composer install --no-dev --optimize-autoloader in the project root. If the extracted project does not include a .env file, duplicate .env.example and rename it to .env. Then add your database credentials and correct APP_URL.
8. Generate Application Key: Open the Hostinger terminal or connect with SSH, go to the project root, and run php artisan key:generate. This will automatically create the APP_KEY value required by Laravel.