Installation Guide

This guide walks you through the complete installation process for Capptro using the installation wizard.

Prerequisites

Before you begin, ensure you have:

• A web server with PHP 8.0+ and MySQL 5.7+ (or MariaDB 10.3+)
• FTP/SFTP access or cPanel file manager
• A valid Capptro license (purchased from the customer portal)
• Database credentials (hostname, database name, username, password)

Step 1: Purchase or Redeem a License

1. Visit the Capptro Portal and create an account
2. Go to Purchase to buy a license, or Redeem if you have a promo code
3. Once purchased, your license will appear in My Licenses

Step 2: Download Your Files

1. Log in to the Capptro customer portal
2. Go to My Licenses page
3. Click "Download Software" to get the application ZIP file
4. Click "Download license.json" to get your license certificate file

Step 3: Upload Files to Server

1. Extract the downloaded ZIP file on your computer
2. Connect to your web server via FTP/SFTP or use cPanel File Manager
3. Upload all files to your desired directory (e.g., public_html/capptro)

Step 4: Create Database

If you don't already have a database, create one:

Using cPanel:

1. Log in to cPanel
2. Go to MySQL Databases
3. Create a new database (e.g., yourusername_capptro)
4. Create a new user with a strong password
5. Add the user to the database with All Privileges

Using Command Line:

mysql -u root -p
CREATE DATABASE capptro;
CREATE USER 'capptro_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON capptro.* TO 'capptro_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Step 5: Run Installation Wizard

The installation wizard will guide you through the rest of the setup:

1. Open your browser and navigate to yourdomain.com/capptro/install.php
2. Requirements Check: The wizard will verify your server meets all requirements
3. Database Setup: Enter your database credentials (host, name, username, password)
4. License Activation: Upload your license.json file or enter your license key
5. Admin Account: Create your administrator account with email and password
6. Complete: Installation is finished!

Step 6: Secure Your Installation

Additional security recommendations:

• Delete install.php and any .sql schema files from your server
• Ensure configuration files are not accessible via web browser
• Use HTTPS for your installation
• Set strong passwords for all user accounts
• Regularly backup your database

Step 7: Initial Configuration

After installation, log in with your admin account and:

1. Go to Settings to configure workflow steps
2. Set up Priority levels with colors
3. Configure Dropdowns (paper types, sizes, products, etc.)
4. Add additional Users if needed
5. Start adding Customers and Work Items

Troubleshooting Installation

Blank page or 500 error

Check your PHP error logs. Common causes:

• PHP version too old (need 8.0+)
• Missing PHP extensions (PDO, JSON, OpenSSL, Mbstring)
• File permissions issues

Database connection failed

• Verify database credentials are correct
• Check if database server is running
• Ensure database user has correct permissions
• Try "localhost" vs "127.0.0.1" for the host

License validation failed

• Check internet connection (server needs to reach capptro.com for online validation)
• Verify license key is entered correctly (format: XXXX-XXXX-XXXX-XXXX)
• Ensure license hasn't expired
• Try uploading the license.json file instead of entering the key manually

Can't download license.json

• Make sure you're logged in to the portal
• Check that you have an active license under "My Licenses"
• Try a different browser or clear your cache
• Contact support if the download still doesn't work

includes directory not writable

• Set permissions: chmod 755 includes or chmod 775 includes
• On shared hosting, use cPanel File Manager to change permissions
• Check with your hosting provider if you can't change permissions