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
publicfolder, 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:
- License — Insira seu Envato purchase code (or skip if not using Envato)
- Requisitos — Automatic check for PHP version, extensions, and permissions
- Banco de Dados — Insira seu MySQL/MariaDB credentials
- Admin — Create your superadmin account
- 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!
Step 6: Create Storage Symlink
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
- Visit
https://yourdomain.com— you should see the pagina inicial - Visit
https://yourdomain.com/login— log in with your superadmin credentials - You're in the Superadmin Panel!
O que Fazer a Seguir
Now that you're installed, here's your quick checklist:
As Superadmin:
- Va para Admin → Plans — review the default planos de assinatura
- Va para Admin → Configuracoes — configure gateways de pagamento (Stripe/PayPal)
- Va para Admin → Landing Page — customize your public pagina inicial
- Va para Admin → Configuracoes → Email — send a test email to verify SMTP
Create Your First Tenant:
- Open a new incognito/private browser window
- Visit
https://yourdomain.com/register - Fill out the registration form (name, email, company, subdomain)
- Verify your email
- Faca login — you're now in the Tenant Painel de Controle
Set Up Your First Product & Campaign:
- Va para Produtos → Create — add your first product
- Va para Campanhas → Create — create a feedback campaign for that product
- Va para Configuracoes → Branding — set your brand colors and logo
- Visit your public pages:
https://yourdomain.com/p/{your-tenant-slug}— Product Hubhttps://yourdomain.com/wall/{your-tenant-slug}— Feedback Wallhttps://yourdomain.com/feedback/{campaign-slug}— Feedback Formhttps://yourdomain.com/roadmap/{your-tenant-slug}— Roadmaphttps://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:
- Superadmin Panel — manage your platform
- Tenant Painel de Controle — learn every feature
- Public Pages — understand the end-user experience
- Configuracao — fine-tune everything