Deployment Overview
Quizix is a full-stack application made of two parts:
- Backend (Admin Panel + API) → Laravel (PHP)
- Frontend (Client Website) → Next.js
Depending on your hosting, these parts can run together on one server or separately on different platforms.
🖥️ VPS / Cloud Server (Recommended)
Examples: DigitalOcean, AWS Lightsail, Google Cloud, Azure, Vultr
✅ Best and recommended option
On a VPS or Cloud server, you can run:
- ✅ Laravel Backend (Admin Panel + API)
- ✅ Next.js Frontend (Standalone)
Both backend and frontend run on the SAME server.
Requirements:
- PHP
8.2 – 8.4 - Node.js
v22+ - Nginx or Apache
- PM2 for frontend process management
⭐ This setup gives full features, real-time updates, and best performance. See Installation Guide
🧩 Separate Hosting (Also Supported)
You may split backend and frontend across different platforms.
🔹 Backend on VPS or cPanel
- Laravel Admin Panel must run on PHP hosting
- Supported on:
- VPS (Apache / Nginx)
- cPanel (Apache)
🔹 Frontend on VPS / Cloud
- Next.js Standalone
- Runs together with backend on VPS
- Uses Node.js + PM2
🔹 Frontend on Vercel / Netlify (Frontend Only)
Vercel and Netlify can NOT run Laravel.
They are used for frontend only.
| Platform | What Runs |
|---|---|
| Vercel | Next.js frontend only |
| Netlify | Next.js frontend only |
⚠️ Platform caching may delay frontend updates.
This is expected behavior and not a product issue. See Installation Guide
🔹 Frontend on cPanel With Node.js Support
Some modern cPanel or shared hosting panels support Node.js.
In that case, you can run Next.js Standalone without VPS.
Requirements:
- Node.js
v22+enabled on cPanel - Ability to run background processes or PM2 (some panels have this)
- Laravel backend still runs on PHP (cPanel default)
⚠️ If Node.js is not supported, only a static export of Next.js will work. See Installation Guide
🧱 cPanel / Shared Hosting (Limited)
- ✅ Laravel Backend works
- ❌ Next.js Standalone does NOT work (unless Node.js is supported)
- ✅ Static frontend export works
- See Installation Guide
🧠 Simple Decision Guide
| Hosting Type | Backend | Frontend |
|---|---|---|
| VPS / Cloud | Laravel | Next.js Standalone |
| VPS + Vercel | Laravel | Next.js (Vercel) |
| cPanel with Node.js | Laravel | Next.js Standalone |
| cPanel with Vercel | Laravel | Next.js (Vercel) |
| cPanel only | Laravel | Static Export |
| Vercel only | ❌ Not possible | ❌ Not possible |
✅ Final Recommendation
If you want the easiest, full-featured, and recommended setup:
👉 Use a VPS or Cloud server and run BOTH backend and frontend together.
If you have cPanel with Node.js, you can still run the Next.js frontend, but some advanced features may require VPS.