Installation
The site shows a 500 error after upload
Check storage/logs/laravel.log. Common causes: PHP below 8.2, missing vendor/ (this package should ship dependencies; if not, run composer install over SSH), storage not writable, wrong document root (Apache not hitting public/index.php).
Installer never appears
The app thinks it is already installed (storage/installed or APP_INSTALLED in .env). A leftover .env from a previous copy will skip the wizard. Use a clean folder or remove the installed flag only if you intend to reinstall (that does not drop MySQL tables by itself).
Requirements page is red
Match the red line: raise PHP, enable the extension in cPanel, or fix directory permissions. GD and Exif are required by Composer even if an older installer screen listed fewer modules.
Purchase code rejected
Use the CodeCanyon license code for this item, not the order number. Whitespace or a code from another product will fail. See License.
Database step fails
Hostname localhost vs 127.0.0.1, wrong password, user not granted on that database, or MySQL user host not %/localhost. Create the DB user in the same panel as the database.
Mail and notifications
No emails at all
SMTP host/port/encryption mismatch. Gmail needs an app password. Global email notifications or per-type toggles may be off (Notification settings). If QUEUE_ENABLE=true and cron is missing, jobs sit forever.
Slack is silent
Webhook URL empty or revoked. Queue cron not running. Slack toggle off for that event.
Due-task reminders never arrive
Need scheduler cron, tasks with due dates, and notification channels enabled. The command runs daily at 08:00 server time.
Daily use
I cannot create a project
No workspace yet, or your role does not allow Create project. Admins set this under Roles.
I cannot see a teammate on Assign
They exist as a user but are not a workspace member. Invite them on the workspace.
Timer will not start / jumps to another task
Only one timer runs per user. Starting a new one stops the previous. Stop from the top bar if the indicator stays on.
Manual time was rejected
Rules in the UI: both start and end required, end after start, not in the future, start after the task was created, maximum 10 hours per manual entry.
Upload failed
Extension not in Allowed file types (Global settings), or PHP upload_max_filesize.
Import skipped most rows
CSV/XLSX needs a header row. title is required. board should match a list name (or a new list is created). Duplicate title+list or existing id/slug is skipped. Only admins can import. Import & export.
AI buttons missing or error
AI disabled, no API key, role Use AI features off, daily/minute rate limit, or demo mode. Run Test connection on AI settings. Embeddings search needs php artisan ai:embed-tasks.
Calendar is empty
Calendar and due-task colors need due dates on tasks.
After an update the site is blank or old
Clear caches (/dev/setup/clear/all or Artisan commands in Update). Rebuild front-end if you deploy Vue changes (yarn build).
Local development
yarn dev vs production assets
If public/hot exists from Vite, the app expects the dev server. For a production-like local run, stop Vite and use yarn build.
Docs site CSS looks broken
The docs live in _documentation and must use that folder’s npm run dev, not the Laravel Vite process. See _documentation/README.md.
← All ProTask – Project Management Software with Time Tracking & Team Collaboration documentation