v1.0.0 Stable
Last Updated: 2026

Installation Guide

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

🖥️ Server Requirements

Your server must meet the following PHP and extension requirements:

  • PHP >= 8.2
  • BCMath PHP Extension
  • Ctype PHP Extension
  • Fileinfo PHP Extension
  • JSON PHP Extension
  • Mbstring PHP Extension
  • OpenSSL PHP Extension
  • PDO PHP Extension

Recommended:

  • MySQL 5.7+ / MySQL 8.0+ / MariaDB 10+
  • Apache or Nginx (URL rewrite enabled)
  • SSL (HTTPS) recommended for payments and QR check-in
  • Outbound HTTPS access allowed (for license verification and integrations)
Note: Ensure allow_url_fopen is enabled for the license verification system.

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.

Warning: If the .env file is missing, Laravel cannot load your app configuration. The website may show a server error, fail to connect to the database, and the installer or admin panel may not work correctly until you complete both required steps: create .env from .env.example and run php artisan key:generate.
  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

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
Shared hosting note: These are required setup steps. If your hosting panel has no terminal access, create the .env file manually from .env.example using File Manager. Then run php artisan key:generate from Terminal/SSH if available. If Terminal is not available, use the built-in web installer so the environment file and application key can be created properly.

Deployment Methods

Choose the environment that matches your hosting provider:

Using the Eventiq Web Installer

  1. Upload the Eventiq.zip file to your domain's root directory.
  2. Extract the files.
  3. Visit yourdomain.com in your browser you will automatically be redirected to the installer.
  4. The wizard will check your server permissions and database connection.
Custom Installer UI
Step 1: Welcome Screen
Custom Installer UI
Step 2: Extension Installation
Custom Installer UI
Step 3: Permission Check
Custom Installer UI
Step 4: Configuration for application
Custom Installer UI
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.
    cPanel 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.
    Public HTML Folder
  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.
    Upload Button
  4. Extract Files: Right-click on the uploaded eventiq.zip and select Extract. Ensure the destination is /public_html.
    Extract Zip File
  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.
    Database Wizard Step 1
  6. Assign Privileges: On the final step of the wizard, check the ALL PRIVILEGES box and click "Make Changes".
    Database Privileges
  7. Domain & Environment: Point your domain to the /public folder via the Domains setting in cPanel. 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.
    Hostinger File Manager Access
    Hostinger File Manager Access
    Hostinger File Manager Access
  2. Select Domain Directory: Navigate to domains/yourdomain.com/public_html. Ensure you are in the correct root directory before uploading.
    Public HTML Directory
  3. Upload Source Code: Click the Upload button (arrow icon). Select eventiq.zip from your local machine and wait for the upload to complete.
    Uploading eventiq.zip
  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.
    Extracting Zip File
  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.
    Database and User Creation
  7. Configure .env File: 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.