Web Installer Walkthrough

FeedbackPulse SaaS includes a beautiful, browser-based installer. No command line needed (after the initial file upload and composer install).

Accessing the Installer

انتقل إلى:

https://yourdomain.com/install

Can't see the installer? Make sure:

Your web server points to the public/ directory

Apache mod_rewrite is enabled (or Nginx has proper try_files)

There is NO storage/installed.lock file (this blocks the installer after first installation)

Step 1: Welcome & License

The first screen welcomes you and asks for your Envato/CodeCanyon purchase code.

Where to find your purchase code:

تسجيل الدخول to CodeCanyon
اذهب إلى Downloads → find FeedbackPulse SaaS
Click Download → License certificate and purchase code
The purchase code looks like: a1b2c3d4-e5f6-7890-abcd-ef1234567890

What it does:

Validates your license with the Envato API
Ensures you have a legitimate copy
Unlocks the rest of the installer

Step 2: المتطلبات Check

The installer automatically scans your server and checks:

PHP Version

PHP 8.2 أو أعلى is required
Shows your current PHP version

Vendor Dependencies

Checks that vendor/autoload.php exists (Composer dependencies must be installed or uploaded)

PHP Extensions

The following are checked:

pdo_mysql — قاعدة البيانات connectivity
mbstring — String handling
openssl — Encryption
tokenizer — Code parsing
xml — XML processing
ctype — Character validation
json — JSON handling
bcmath — Math operations
fileinfo — File type detection
curl — API calls

Directory Permissions

storage/ — Must be writable
bootstrap/cache/ — Must be writable

Result Display

Green checkmarks = requirement met
Red crosses = requirement NOT met (must fix before proceeding)

Fixing failed checks:

# Install missing PHP extensions (Ubuntu)
sudo apt install php8.2-mysql php8.2-mbstring php8.2-xml php8.2-bcmath php8.2-curl php8.2-gd php8.2-zip

# Fix permissions
sudo chmod -R 775 storage bootstrap/cache
sudo chown -R www-data:www-data storage bootstrap/cache

# Restart PHP
sudo systemctl restart php8.2-fpm

Step 3: قاعدة البيانات التكوين

أدخل MySQL/MariaDB connection details:

الحقل	مثال	Notes
قاعدة البيانات Host	`127.0.0.1`	Use `127.0.0.1` instead of `localhost` for reliability
قاعدة البيانات Port	`3306`	Default MySQL port
قاعدة البيانات Name	`feedbackpulse`	Must exist already!
قاعدة البيانات Username	`feedbackpulse_user`	With full privileges on the database
قاعدة البيانات Password	`your_secure_password`	The user's password

Before This Step

You must create the database first:

-- Log into MySQL
mysql -u root -p

-- Create the database
CREATE DATABASE feedbackpulse CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- Create a dedicated user (recommended)
CREATE USER 'feedbackpulse_user'@'localhost' IDENTIFIED BY 'your_secure_password';
GRANT ALL PRIVILEGES ON feedbackpulse.* TO 'feedbackpulse_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

What Happens When You Click "Setup قاعدة البيانات"

The installer tests the connection
Saves your database credentials to the .env file
Runs all database migrations (creates ~30 tables)
Seeds default data:
- 3 default خطط الاشتراك (Starter, Growth, Pro)
- Default platform settings
Shows a success message

ملاحظة: Session and cache drivers remain as file during installation for stability. They are switched to database automatically at the completion step.

This step may take 10-30 seconds depending on your server.

Step 4: Admin Account

Create your superadmin account:

الحقل	مثال	Notes
Full Name	John Smith	Your display name
Email Address	[email protected]	Used for login and notifications
Password	(strong password)	Minimum 8 characters. Use a strong password!
Confirm Password	(must match)	Must match

What Happens

Creates your user account with role = superadmin
This is the only superadmin account created automatically
You'll use this to log in at /login and access /admin/dashboard

الأمان tip: Use a unique, strong password. You can enable 2FA later in الإعدادات.

Step 5: Email التكوين

Configure SMTP for sending transactional emails:

الحقل	مثال	Notes
SMTP Host	`smtp.gmail.com`	Your email provider's SMTP server
SMTP Port	`587`	587 for TLS, 465 for SSL
SMTP Username	`[email protected]`	Usually your email address
SMTP Password	`your_app_password`	App-specific password recommended
Encryption	`tls`	TLS (recommended) or SSL
From Address	`[email protected]`	The "from" address on outgoing emails
From Name	`FeedbackPulse`	The "from" name on outgoing emails

Common SMTP Providers

Provider	Host	Port	Encryption	Notes
Gmail	`smtp.gmail.com`	587	TLS	Requires App Password (not regular password)
Mailgun	`smtp.mailgun.org`	587	TLS	Great for transactional email
Amazon SES	`email-smtp.{region}.amazonaws.com`	587	TLS	Cost-effective at scale
SendGrid	`smtp.sendgrid.net`	587	TLS	Use `apikey` as username
Postmark	`smtp.postmarkapp.com`	587	TLS	Best deliverability
Mailtrap	`sandbox.smtp.mailtrap.io`	587	TLS	For testing only!

Can't configure email now? You can skip this step and configure it later in Admin → الإعدادات → Email. The platform will work without email, but features like invitations, digests, and password resets won't function.

Step 6: التثبيت Complete!

You'll see a success page with:

قاعدة البيانات configured and migrated
Admin account created
Email configured
installed.lock file created
Session and cache drivers switched to database
CRON_TOKEN auto-generated for web-based cron
Shared hosting notice (if symlink couldn't be created)

Cron Job Instructions (shown on completion page)

The completion page displays two cron setup options with copy-paste commands:

CLI Command — for VPS/dedicated servers:

* * * * * cd /path/to/project && php artisan schedule:run >> /dev/null 2>&1

URL/wget — for الاستضافة المشتركة (uses the auto-generated CRON_TOKEN):
```
wget -q -O /dev/null "https://yourdomain.com/cron/run?token=YOUR_CRON_TOKEN"
```

Save these! Copy the cron command from the completion page before navigating away. You can also find your CRON_TOKEN in the .env file.

The `installed.lock` File

The installer creates storage/installed.lock to prevent anyone from re-running the installer. This is a security measure.

To re-run the installer (e.g., fresh install), delete this file:
rm storage/installed.lock
Then visit /install again.

Post-التثبيت Checklist

After the installer completes:

Set up the مهمة cron using the instructions shown on the completion page (see Cron Jobs & Queue Workers)
تسجيل الدخول at https://yourdomain.com/login with your superadmin credentials
Visit Admin → Plans — review and customize خطط الاشتراك
Visit Admin → الإعدادات → Payments — connect Stripe/PayPal
Visit Admin → الإعدادات → Email — send a test email
Visit Admin → Landing Page — customize your public homepage
Set up SSL (see SSL Certificates)
Optionally set up wildcard DNS (see Wildcard DNS Setup)

الخطوات التالية

Apache التكوين or Nginx التكوين
Environment Variables — fine-tune your .env
Cron Jobs & Queue Workers — set up automated tasks

Accessing the Installer​

Step 1: Welcome & License​

Step 2: المتطلبات Check​

PHP Version​

Vendor Dependencies​

PHP Extensions​

Directory Permissions​

Result Display​

Step 3: قاعدة البيانات التكوين​

Before This Step​

What Happens When You Click "Setup قاعدة البيانات"​

Step 4: Admin Account​

What Happens​

Step 5: Email التكوين​

Common SMTP Providers​

Step 6: التثبيت Complete!​

Cron Job Instructions (shown on completion page)​

The installed.lock File​

Post-التثبيت Checklist​

الخطوات التالية​