Pular para o conteúdo principal

Guia de Inicio Rapido

Get FeedbackPulse SaaS up and running in 15 minutes. This is the express version — for detailed instructions, see the full Instalacao Guide.


Antes de Comecar

Certifique-se de ter:

  • Um servidor ou VPS (Ubuntu 22.04+ recomendado)
  • PHP 8.2 ou superior
  • MySQL 8.0+ ou MariaDB 10.6+
  • Servidor web Apache ou Nginx
  • Um nome de dominio apontando para o seu servidor
  • Uma conta de e-mail SMTP (Gmail, Mailgun, etc.)

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

Abra seu navegador and navigate to:

https://yourdomain.com/install

The installer will guide you through 5 steps:

  1. License — Insira seu Envato purchase code (or skip if not using Envato)
  2. Requisitos — Automatic check for PHP version, extensions, and permissions
  3. Banco de Dados — Insira seu MySQL/MariaDB credentials
  4. Admin — Create your superadmin account
  5. Email — Configure SMTP settings

Dica: Have your database credentials and SMTP details ready before starting the installer.


Step 5: Set Up Cron Job

FeedbackPulse needs a tarefa cron to run scheduled tasks (resumo por e-mails, trial expiry, retencao de dados, 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 pagina inicial
  2. Visit https://yourdomain.com/login — log in with your superadmin credentials
  3. You're in the Superadmin Panel!

O que Fazer a Seguir

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

As Superadmin:

  1. Va para Admin → Plans — review the default planos de assinatura
  2. Va para Admin → Configuracoes — configure gateways de pagamento (Stripe/PayPal)
  3. Va para Admin → Landing Page — customize your public pagina inicial
  4. Va para Admin → Configuracoes → 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. Faca login — you're now in the Tenant Painel de Controle

Set Up Your First Product & Campaign:

  1. Va para Produtos → Create — add your first product
  2. Va para Campanhas → Create — create a feedback campaign for that product
  3. Va para Configuracoes → 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} — Roadmap
    • https://yourdomain.com/changelog/{your-tenant-slug} — Registro de Alteracoes

You're Live!

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