Install PHP Application (install.zip)
What install.zip contains
- Laravel application source code.
- public assets and application routes.
- modules for admin, user workspace, WhatsApp tools, AI tools, payments, support, and settings.
- vendor dependencies required to run the PHP application.
- a production-safe .env template for installer use.
- empty storage and bootstrap/cache folders prepared for runtime files.
What install.zip does not contain
- node_modules.
- tests.
- the outer marketplace release folder.
- your local development .env.
- runtime logs, cache files, uploaded private files, or old storage data.
- the Node WhatsApp server. That is provided separately as whatsapp_server.zip.
Upload install.zip
- Extract waziper-10.1.0.zip on your computer.
- Find install.zip inside the extracted package.
- Upload install.zip to your hosting account or VPS application folder.
- Extract install.zip on the server.
- Make sure the extracted files are directly in the target application folder, not inside an extra install or release folder.
Correct folder structure after extraction
- app/
- bootstrap/
- config/
- database/
- modules/
- public/
- resources/
- routes/
- storage/
- vendor/
- .env
- artisan
- composer.json
Incorrect folder structure
- public_html/install/app
- public_html/release/app
- public_html/waziper/app
- public_html/waziper-10.1.0/install.zip still not extracted
Document root
- Best practice: point your domain document root to the public folder.
- Example: /home/user/waziper/public
- If your hosting control panel cannot point to public, use the package root files as provided and keep .htaccess enabled.
Permissions
- storage must be writable by the web server.
- bootstrap/cache must be writable by the web server.
- Do not make all files globally writable unless your hosting support specifically requires it.
Run the installer
- Open your domain in the browser.
- Follow the installer steps.
- Enter database host, port, database name, username, and password.
- Create the first admin account.
- Finish installation, then log in to the admin dashboard.
After installer completes
- Set APP_INSTALLED=true if your installer does not do it automatically.
- Clear cache if needed with php artisan optimize:clear.
- Go to Admin Dashboard -> System Information and confirm all checks pass.
- Go to Admin Dashboard -> Settings and update branding, timezone, mail, files, AI, and payment settings.
Common install.zip mistakes
- Uploading waziper-10.1.0.zip instead of install.zip.
- Extracting install.zip into a nested folder and pointing the domain to the wrong level.
- Forgetting to make storage and bootstrap/cache writable.
- Using the wrong PHP version.
- Using localhost database credentials from another machine instead of the server database credentials.
- Installing the PHP app but forgetting to install whatsapp_server.zip for WhatsApp features.