← Documentation·Setup & installation

For installation

●  Updated May 2026Mewayz

Mewayz Products Installation Guide

Complete guide to install and configure Mewayz products with easy step-by-step instructions.

1. Welcome

This documentation will guide you through the installation and configuration of the product.

While the installation process is straightforward, some instructions require basic understanding of databases and server file management.

2. License

2.1 Regular License

Use by you or one client, in a single end product which end users are **not charged for**. The total price includes the item price and buyer fee.

2.2 Extended License

Use by you or one client, in a single end product which end users **can be charged for**. The total price includes the item price and buyer fee.

Important: Please purchase an “Extended License” if you plan to sell this as a service. Envato License Policy

3. Installation Methods

3.1 Video Guides

3.2 Built-in Installer

The product comes with a “web installer”. Follow the steps below to install on your server.

4. Server Requirements

Built on **“PHP 8.3.*”** with the following minimum requirements:

4.1 Requirement

4.2 Required PHP Extensions:

Note: The installer will automatically check if your server meets these requirements.

5. Database Setup

Step 1: Create Database

Create a new “empty database” using your hosting control panel.

Step 2: Create Database User

  1. Create a new database user
  1. Assign “full permissions” to the database
  1. Note down the credentials for installation

6. File Upload

Step 1: Show Hidden Files

Enable viewing of “hidden files” in your file manager (dotfiles like .env are hidden by default).

Step 2: Upload Files

Upload contents of the main_file folder to your domain’s web root directory:

7. Installation Wizard

Step 1: Start Installation

Deleted:

Visit: https://yourdomain.com/install

Step 2: Check Requirements

Click “Check Requirements” button to verify server compatibility.

Step 3: Check Permissions

Click “Check Permissions” to verify directory permissions.

Step 4: Set Permissions (if needed)

If permission errors occur, run:

Step 5: Database Configuration

Enter your database credentials:

Step 6: Complete Installation

Follow the remaining wizard steps to complete installation.

8. Web Server Configuration

8.1 Apache (Default)

No additional configuration needed if using Apache with .htaccess support.

8.2 Nginx Setup

Create Nginx configuration file in /etc/nginx/sites-available/:



    server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;
    root /path/to/your/project;
    index index.php index.html;
                                                    
    # Security headers
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header X-Content-Type-Options "nosniff" always;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
                                                    
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.3-fmp.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
                                                                                       
     location ~ /\.ht {
        deny all;
    }
                                                
    # Cache static assets
    location ~* \.(css|js|png|jpg|jpeg|gif|ico|woff|woff2|ttf|svg|pdf|doc|docx|csv|zip|mp4|mp3)$ {
        expires 1y;
         add_header Cache-Control "public, immutable";
        log_not_found off;
        access_log off;
    }
                                                
    # Handle public assets
    location ~* ^/public/(css|assets|market_assets|images|landing|uploads|storage|installer|js|vendor|build|screenshots|packages)/(.*)$ {
        try_files $uri $uri/ =404;
    }
                                                
    error_log /var/log/nginx/yourdomain_error.log;
    access_log /var/log/nginx/yourdomain_access.log;
}

Enable the site:

9. SSL Certificate Setup

9.1 Using Let’s Encrypt (Free)

sudo apt install certbot python3-certbot-nginx

9.2 Get SSL certificate

sudo crontab -e

Add: 0 12 * * * /usr/bin/certbot renew –quiet

9.2 Using Cloudflare (Recommended)

  1. Add your domain to Cloudflare
  1. Update nameservers
  1. Enable SSL/TLS encryption
  1. Set SSL mode to “Full (strict)”

10. Upgrade Documentation

10.1 Before You Start

Always backup your application and database before upgrading to prevent data loss. Check the release notes for any breaking changes and ensure your server meets the latest system requirements.

Important: Test the upgrade process on a staging environment first before applying to production.

10.2 Pre-Upgrade Checklist

Create a complete backup of your database using your hosting panel or command line tools. Backup all important files including storage directory and your .env configuration file. Note down your current version number and any custom modifications you’ve made to the application.

System Requirements: Verify your server has PHP 8.3+, MySQL 8.0+, Node.js 18+, and Composer 2.0+ installed.

10.3 Backup Process

10.4 Upgrade Process

Step 1: Preparation

Put your application in maintenance mode to prevent users from accessing it during the upgrade. This ensures data integrity and prevents any issues during the update process.

php artisan down

Step 2: File Replacement

Download the new version from your purchase source and extract it to a temporary location. Replace all application files except your .env file and storage directory folder to preserve your data and configuration.

Step 3: Complete Upgrade

Take your application out of maintenance mode.

php artisan up

Log in and follow the update wizard.

10.5 Version-Specific Updates

Each version may include new features, improvements, or breaking changes that require special attention during upgrade. Review the specific changes for your target version to understand what updates are included.

10.6 Post-Upgrade Verification

10.7 Troubleshooting

10.8 Rollback Procedure

If the upgrade fails or causes issues, immediately put the application in maintenance mode and restore from your backups. Restore the database from your SQL backup file and replace application files with your backup copies.

10.9 Custom Code Migration

If you have custom modifications, carefully compare your backup files with the new version to identify changes. Reapply your customizations while ensuring compatibility with the new version.

10.10 Final Steps

10.11 Upgrade Complete!

Your application has been successfully upgraded. Monitor the application closely for the first few days and contact support if you encounter any issues.

Support: Keep your backup files for at least one week after upgrade in case rollback is needed.

11. Default Login Details

After successful installation, you’ll receive default admin credentials:

Security: Change the default password immediately after first login.

12. Essential Configuration

12.1 Application Settings

12.2 Storage Configuration

12.3 Set proper permissions

13. Payment Gateway Setup

Configure payment gateways in the admin panel:

13.1 Supported Gateways:

Documentation: Payment Gateway Setup Guide

14. Post-Installation Steps

14.1 Essential Tasks:

14.2 Optional Enhancements:

15. Troubleshooting

15.1 Common Issues:

Contact our support team with:

16. Security Recommendations

17. Frontend Customization

Customize the application’s UI/UX by modifying React components located in resources/js/ directory. Edit components, pages, and layouts as needed, then rebuild assets using npm run build for production or npm run dev for development with hot reload.

Important: Always run npm run build after making frontend changes for production.

17.1 Installation Complete!

Your Web application is now ready to use. Access the admin panel to configure settings and start creating digital business cards.

Support: For technical assistance, please contact our support team with detailed error information.

Take your business to the next level with great website!

Feel Free To Reach Out to Discuss Your Next Web Development Project.

First Name *

Last Name

Email Address *

Phone Number

More Details

Was this helpful?
← All docsAsk the teamTry it free →