AppitNow Installation Wizard

Choose Installation Target

Select where you want to install AppitNow. The installer will automatically configure database settings for your chosen environment.

🏠

macOS Localhost

Install locally using MAMP Pro SQL on macOS. Database runs on port 8889 with default credentials.

MAMP Pro

☁️

CloudPanel

Install on a CloudPanel server. Create your database in CloudPanel first, then enter credentials.

CloudPanel

💡 Tip: The installer auto-detects your environment. If a card shows "✅ Detected", it found matching software on your system. You can still choose the other option manually.

Step 1: Database Configuration

Connect to your MySQL database. The form is pre-filled for your selected installation target.

Database Host

Database Port

Database Name

Database Username

Database Password

⚠️ You must click "Test Connection" before continuing.

MAMP Pro: Default is host 127.0.0.1, port 8889, user root, password root
CloudPanel: Create the database in CloudPanel first, then enter those credentials here
If connection fails, make sure MySQL is running (green light in MAMP Pro, or systemctl status mysql on Linux)

Step 2: Application Settings

Configure basic application settings.

Your Domain (include https://)

JWT Secret (auto-generated)

Environment

⚠️ Important — Domain URL must match your runtime:

Localhost testing: Use http://localhost:3000
Production: Use your real domain like https://yourdomain.com
If this doesn't match, checkout payment redirects will go to the wrong host after payment
The JWT Secret is auto-generated and secure — no need to change it unless you want to

Step 3: Payment Gateway Configuration

Configure payment gateways. Paddle is the primary gateway, others are optional fallbacks.

ℹ️ Payment System: Paddle is configured as the primary gateway. Stripe, 2Checkout, and SSLCommerz are disabled by default and can be enabled later from the admin panel. All settings are stored in the database and can be toggled without code changes.

📚 How to get Stripe keys:

Go to: https://dashboard.stripe.com/apikeys
Copy your Secret key (starts with sk_live_ or sk_test_)
Webhook secret will be configured after deployment

Enable Stripe

📌 Stripe keys — what works and what doesn't:

✅ Real test key (sk_test_...): Free from Stripe Dashboard. Checkout works with test card 4242 4242 4242 4242
✅ Real live key (sk_live_...): For production with real payments
❌ Placeholder key: Lets you finish the installer, but checkout will show "Stripe is not configured" until you replace it in .env
💡 No Stripe at all? Skip this step. Paddle is the primary gateway, and you can test it in Sandbox mode.

Step 4: Paddle Configuration (Primary Gateway)

Configure Paddle - the primary payment gateway for cards, PayPal, and international payments.

⭐ Primary Gateway: Paddle is set as the default checkout system. It handles cards, PayPal, and local payment methods in one hosted checkout. You can enable Stripe/2Checkout/SSLCommerz later as admin-controlled fallbacks.

📚 How to get Paddle keys:

Go to: Paddle Dashboard
Create an API Key under "API Keys"
Create a Client Token under "Client-side Tokens"

Enable Paddle

📌 Paddle keys — sandbox vs live:

✅ For localhost: Use sandbox keys (pdl_sdbx_...) from Paddle Sandbox Dashboard
❌ Don't use live keys (pdl_live_...) on localhost — they will fail with "Paddle API Error"
✅ After sandbox payment: Paddle must redirect back to /checkout/success. That success route verifies the transaction and creates the AppitNow payment record and license.
💡 No Paddle key at all? Leave empty. However, you must configure at least one gateway (Paddle, Stripe, etc.) for live checkout to function.
Check "Use Sandbox Mode" if you're using sandbox keys

Step 5: SSLCommerz Configuration

Configure SSLCommerz for Bangladesh payments (optional).

📚 How to get SSLCommerz credentials:

Go to: https://sslcommerz.com/
Sign up for a merchant account
Get Store ID and Store Password from dashboard

Enable SSLCommerz

📌 SSLCommerz — for Bangladesh-based payments:

You need a merchant account at sslcommerz.com
Use sandbox credentials for testing — check "Use Sandbox Mode"
If you're not targeting Bangladesh customers, you can skip this step entirely

Step 6: Email Configuration

Configure Resend for sending license keys to customers. You can leave this blank and add it later.

📚 Recommended: Resend

Sign up at: https://resend.com
Verify your sending domain
Create an API key

Use placeholder keys Fill with dummy values to skip for now — you can update .env later

Resend API Key (optional)

From Email Address (required only if Resend is configured)

📌 Email setup tips:

Email is used to send license keys to customers after purchase
Skip for now? Leave both fields blank or use placeholder. You can add real keys to .env later
If you provide an API key, you must also provide a From email address (and vice versa)
The From email must be from a domain you've verified in Resend

Step 7: Create Admin User

Create the initial superadmin account.

Admin Email

Admin Password (min 8 characters)

Confirm Password

Full Name (optional)

📌 Admin account tips:

This creates the SUPERADMIN account — full control over the entire system
Use a strong password (8+ characters, mix of letters, numbers, symbols)
Remember these credentials — you'll need them to log in after installation
You can create additional admin users later from the admin panel

Step 8: Review & Install

Review your configuration and start the installation.

Preparing installation...

📌 Before you click Install:

Review the summary above — you can click Back to change any setting
The installer will create .env files, run database migrations, and create your admin account
If installation fails, check the error message — you can fix the issue and retry without losing progress
Any placeholder/dummy keys can be replaced in .env after installation

🎉 Installation Complete!

AppitNow has been successfully installed and configured.

📝 Next Steps:

Build the application: npm run build
Start the server: npm start
Configure webhook secrets after deployment
Set up SSL/HTTPS before going live
Review security settings in DEPLOYMENT_GUIDE.md

📌 Post-install checklist:

Localhost? Make sure NEXT_PUBLIC_APP_URL=http://localhost:3000 in your .env
Test checkout: Use Paddle Sandbox keys to test checkout safely before going live. A successful payment should leave the Paddle overlay and reach /checkout/success; otherwise the AppitNow transaction/license will not be recorded.
Replace placeholders: Update any dummy keys in .env with real ones before going live
Stripe: Needs a real sk_test_ key for checkout to work (free from Stripe Dashboard)
Paddle: Use sandbox keys (pdl_sdbx_) for testing, save live keys for production

🚀 AppitNow Installation Wizard

✅ Installation Already Complete

Choose Installation Target

macOS Localhost

CloudPanel

Step 1: Database Configuration

Step 2: Application Settings

Step 3: Payment Gateway Configuration

📚 How to get Stripe keys:

Step 4: Paddle Configuration (Primary Gateway)

📚 How to get Paddle keys:

Step 5: SSLCommerz Configuration

📚 How to get SSLCommerz credentials:

Step 6: Email Configuration

📚 Recommended: Resend

Step 7: Create Admin User

Step 8: Review & Install

🎉 Installation Complete!

📝 Next Steps: