Installation.

📋 Who This Is For

Reward Loyalty is self-hosted source code for developers and agencies. You'll need basic Laravel/PHP experience and your own hosting. We provide the code and comprehensive documentation—you handle deployment and maintenance.

Install Reward Loyalty on your server by following these steps.

Quick Start

1. Extract the downloaded package
2. Upload files to your web directory
3. Visit your domain
4. Follow the installation wizard

Detailed Steps

Step 1: Extract and Upload

After purchasing Reward Loyalty, download the package from the current purchase store (linked on the /buy page). Extract the contents of the public_html directory and upload them to your web root.

Important: Install at your domain root (e.g., loyalty.example.com), not in a subdirectory (e.g., example.com/loyalty). Use a subdomain if needed.

Step 2: Run the Installer

Navigate to your domain in a browser. You'll see the installation wizard with a modern sidebar showing your progress through three steps: Requirements, Configuration, and Install.

Installation Wizard Steps

Step 1: Requirements

The wizard begins by verifying your server compatibility.

Once all checks pass, you'll see a System Ready confirmation. Click View technical details to see the full list of PHP extensions and versions.

The requirements include:

PHP Extensions (23 checks):

• PHP ≥ 8.4.0 with required extensions
• BCmath, Ctype, cURL, DOM, Exif, Fileinfo, Filter
• GD, Hash, Iconv, Intl, JSON, Libxml, Mbstring
• OpenSSL, PCRE, PDO, PDO SQLite, Session
• Tokenizer, XML, Zlib, Zip
• MySQL 5.7+ or MariaDB 10.3+ with InnoDB storage engine (default on most servers)

Environment checks:

• Root directory writable , verifies the installer can create the .env file. If your web root isn't writable, you'll see instructions for adjusting permissions
• Domain root installation , detects subdirectory installations (e.g., example.com/loyalty) that break routing and asset URLs. If detected, you'll see guidance to use a subdomain instead (e.g., loyalty.example.com)

Note: Locale segments in the URL (e.g., /en-us/install) are not subdirectories — the installer correctly ignores them.

If any check fails, contextual help appears with inline code examples. The technical details accordion opens when issues are found.

Click Configure Instance to proceed.

Step 2: Configuration

Set up your application settings, admin account, and database connection.

Platform Settings:

• Platform Name — The name displayed throughout your installation
• Time Zone — Select your timezone (defaults to your browser's detected timezone)

Admin Account:

• Name — Your display name as administrator
• Email Address — Used for login (receives OTP codes)
• Password — Set a strong password
• Confirm Password — Re-enter to verify

Database Connection:

• Driver — Choose MySQL/MariaDB or SQLite
• Host — Database server address (e.g., 127.0.0.1)
• Port — Database port (default: 3306 for MySQL)
• Database Name — The database to use

Email Configuration: Configure email delivery by selecting a mail driver. Email is essential—Reward Loyalty uses passwordless OTP authentication. See Email Configuration for detailed setup instructions.

⚠️ Warning: Without working email, no one can log in. Always test your email configuration before proceeding.

Step 3: Ready to Launch

Review your configuration and optionally enable demo data before installing.

The page displays:

Configuration Summary:

• Your admin name and email address
• Selected database driver
• Selected mail driver

System Access Points:

• Admin Dashboard , where you'll manage the platform
• Partner Dashboard , for business owners
• Staff Dashboard , for employees

Demo Data Option

At the top of Step 3, you'll find the demo data toggle—a powerful feature for evaluating the platform.

What the toggle does:

When enabled (recommended for testing), the installer populates your database with:

• Sample partners, members, and staff accounts
• Demo loyalty cards and stamp cards
• Example voucher campaigns
• Historical transaction data for analytics

Demo credentials displayed:

When enabled, the access points section expands to show demo login credentials:

When to enable demo data:

• ✅ Client demonstrations — Show realistic dashboards instantly
• ✅ Feature exploration — See how all features work together
• ✅ Training — Let staff practice without risk
• ✅ Testing — Evaluate before going live

When to skip demo data:

• Production deployments
• When migrating real data
• If you prefer starting with a clean database

💡 Tip: Demo data cannot be enabled after installation.

What happens with demo data disabled:

You'll see an amber warning: "You will start with a completely empty database." This is fine for production—just means you'll create all content from scratch.

Installing

Click Install Now to begin the installation process.

The installer will:

1. Create database tables
2. Run migrations
3. Seed demo data (if enabled)
4. Save your configuration to .env
5. Set up the admin account

Installation time:

• Without demo data: Under 30 seconds
• With demo data: 30-60 seconds (additional seeding time)

⚠️ Important: Keep this page open during installation. Do not refresh or navigate away.

After Installation

After successful installation, you'll be redirected to the admin login page.

Log in using the admin email and password you configured in Step 2.

First steps as admin:

1. Go to License & Updates to activate your license
2. Create your first network
3. Assign a manager or create partners directly

If you enabled demo data:

Your dashboards will already show realistic analytics, the homepage displays example loyalty cards, and you can log in to partner/staff accounts using the demo credentials to explore different user perspectives.

Troubleshooting

Installation takes too long with demo data

This is expected behavior. Demo seeding adds 30-60 seconds to installation time. Wait for completion—do not refresh the page.

Demo credentials don't work after installation

The demo data toggle was not enabled during installation. Either reinstall with the toggle enabled, or create accounts manually through the admin dashboard.

Empty dashboards despite enabling demo data

Installation may have failed partway through. Check your server error logs and reinstall if needed.

Cannot log in after installation

Email configuration may be incorrect. The login system requires working email to send verification codes. Check your email settings and ensure test emails are delivered.

Local Development

For local development, use Laravel's built-in server:

cd /path/to/reward-loyalty
php artisan serve

Access the application at http://localhost:8000.

Next Steps

• Updating, activate your license for one-click updates
• Administration Guide, learn how to manage the platform