This guide is for users with VPS or dedicated servers. If you are using a shared host or local environment, check the relevant installation guides.
Prerequisites
Ensure your server meets the server requirements. You will need:- A clean VPS or dedicated server (Ubuntu 20.04+ recommended)
- Root or sudo access
- A domain name pointed to your server’s IP
- Node.js (v18+), MongoDB (or MongoDB Atlas), and Nginx (recommended)
Step 1: Prepare Your Server
- Connect via SSH:
- Install Node.js:
- Install MongoDB (optional if using Atlas):
- Install PM2 process manager:
- Install Nginx (optional, for HTTPS and proxying):
Step 2: Upload, Extract & Install Dependencies
- Upload your script files via SFTP or SCP:
- Extract the archive:
- Install backend dependencies:
- Ensure the public files are accessible via domain:
Restart Nginx after editing:
Step 3: Installation via Web Wizard
Once files are uploaded and dependencies are installed, open your browser:License Activation
- Enter your license key.
- If you don’t know it, go to https://pay.jooj.us/ and log in with your purchase email.
Database Configuration
- Enter your MongoDB connection URI. You can use either:
<username>, <password>, <cluster>, and <database> with your actual values.)If you are using MongoDB Atlas, you can find your connection string in your Atlas dashboard under Database > Connect > Drivers.B. Self-hosted MongoDB on VPS (local MongoDB)Example:<your-server-ip> with your VPS IP address and <database> with your database name.)You will also be asked to enter a JWT secret key. You can either paste your own or click Generate to auto-generate one securely.Step 4: Running the Script
- Ensure you’re in the project directory:
- Start the server using PM2:
- Enable auto-start on reboot:
Recommended VPS Providers
We suggest the following VPS providers for stable hosting:- DigitalOcean — Easy setup and $200 in free credits
- Vultr — Great for small deployments
- Hetzner — Budget-friendly, powerful servers
- Contabo — Affordable and large storage
- AWS EC2 — Enterprise-grade flexibility
For best results, choose a VPS with at least 2GB RAM and 1 vCPU.
After Installation
- Your admin dashboard will be available at:
- You can now log in using the admin credentials created during the installation.
If you encounter issues, refer to the Troubleshooting Guide or contact support@jooj.us.

