إنتقل إلى المحتوى الرئيسي

دليل البدء السريع

Get FeedbackPulse SaaS up and running in 15 minutes. This is the express version — for detailed instructions, see the full التثبيت Guide.

قبل البدء​

تأكد من أن لديك:

  • خادم أو VPS (يُوصى بـ Ubuntu 22.04+)
  • PHP 8.2 أو أعلى
  • MySQL 8.0+ أو MariaDB 10.6+
  • خادم ويب Apache أو Nginx
  • اسم نطاق يشير إلى خادمك
  • حساب بريد إلكتروني SMTP (Gmail، Mailgun، إلخ.)

Step 1: Upload Files​

Upload the FeedbackPulse SaaS files to your server's web directory:

# Example for a typical VPS
cd /var/www
unzip feedbackpulse-saas.zip
cd feedbackpulse-saas

Step 2: Set Permissions​

# Storage and cache must be writable
chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

Step 3: Point Your Web Server​

Your web server must point to the public directory — this is critical!

Apache — Create a virtual host:

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot /var/www/feedbackpulse-saas/public

    <Directory /var/www/feedbackpulse-saas/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Nginx — Create a server block:

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/feedbackpulse-saas/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Critical: The web root must be the public folder, NOT the project root. This is a Laravel security requirement.

Step 4: Run the Web Installer​

افتح متصفحك and navigate to:

https://yourdomain.com/install

The installer will guide you through 5 steps:

  1. License — أدخل Envato purchase code (or skip if not using Envato)
  2. المتطلبات — Automatic check for PHP version, extensions, and permissions
  3. قاعدة البيانات — أدخل MySQL/MariaDB credentials
  4. Admin — Create your superadmin account
  5. Email — Configure SMTP settings

نصيحة: Have your database credentials and SMTP details ready before starting the installer.

Step 5: Set Up Cron Job​

FeedbackPulse needs a مهمة cron to run scheduled tasks (ملخص البريد الإلكترونيs, trial expiry, الاحتفاظ بالبيانات, etc.).

On VPS / Dedicated:

crontab -e

Add this line:

* * * * * cd /var/www/feedbackpulse-saas && php artisan schedule:run >> /dev/null 2>&1

On Shared Hosting (URL-based cron):

Use the web cron endpoint with the CRON_TOKEN shown on the installer completion page:

wget -q -O /dev/null "https://yourdomain.com/cron/run?token=YOUR_CRON_TOKEN"

The installer completion page shows both options pre-filled. Just copy and paste!

This makes uploaded files (logos, photos) accessible from the web:

php artisan storage:link

Shared hosting? If symlinks aren't supported, skip this step. FeedbackPulse automatically serves files via a built-in PHP fallback route.

Step 7: Verify It Works​

  1. Visit https://yourdomain.com — you should see the صفحة الهبوط
  2. Visit https://yourdomain.com/login — log in with your superadmin credentials
  3. You're in the Superadmin Panel!

ماذا تفعل بعد ذلك​

Now that you're installed, here's your quick checklist:

As Superadmin:​

  1. اذهب إلى Admin → Plans — review the default خطط الاشتراك
  2. اذهب إلى Admin → الإعدادات — configure بوابات الدفع (Stripe/PayPal)
  3. اذهب إلى Admin → Landing Page — customize your public صفحة الهبوط
  4. اذهب إلى Admin → الإعدادات → Email — send a test email to verify SMTP

Create Your First Tenant:​

  1. Open a new incognito/private browser window
  2. Visit https://yourdomain.com/register
  3. Fill out the registration form (name, email, company, subdomain)
  4. Verify your email
  5. تسجيل الدخول — you're now in the Tenant لوحة التحكم

Set Up Your First Product & Campaign:​

  1. اذهب إلى المنتجات → Create — add your first product
  2. اذهب إلى الحملات → Create — create a feedback campaign for that product
  3. اذهب إلى الإعدادات → Branding — set your brand colors and logo
  4. Visit your public pages:
    • https://yourdomain.com/p/{your-tenant-slug} — Product Hub
    • https://yourdomain.com/wall/{your-tenant-slug} — Feedback Wall
    • https://yourdomain.com/feedback/{campaign-slug} — Feedback Form
    • https://yourdomain.com/roadmap/{your-tenant-slug} — خارطة الطريق
    • https://yourdomain.com/changelog/{your-tenant-slug} — سجل التغييرات

You're Live!​

Congratulations! FeedbackPulse SaaS is now running on your server. Head to the detailed documentation sections to learn about all the features: