跳到主要内容

快速入门指南

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 Web 服务器
  • 指向您服务器的域名
  • 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 定时任务 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: