Requirements & Installation

2.1 Server Requirements

Deprixa Plus requires a standard LEMP or LAMP stack. The following table lists minimum and recommended specifications for a production deployment.

Core Requirements

Required PHP Extensions

Additional Requirements

• mod_rewrite (Apache) or try_files (Nginx) — required for clean URL routing.
• Composer 2.x — PHP dependency manager, required for installation.

Optional System Binaries

Not required to install or run Deprixa Plus. If present on the server, the invoice parser can extract text from uploaded PDF/image invoices automatically; if absent, that step is skipped without errors and the invoice can still be processed manually.

2.2 Shared Hosting / VPS / cPanel

Deprixa Plus can be deployed on a variety of hosting environments. Here is a quick guide for the most common setups.

cPanel / Shared Hosting

If your hosting provider offers cPanel with SSH access and PHP 8.2+, you can run Deprixa Plus on shared hosting.

1. Upload the ZIP file to your account via File Manager or SFTP.
2. Extract the contents into public_html (for the primary domain) or into a subdirectory and point a subdomain to it (e.g., app.yourdomain.com → public_html/deprixa-plus/public).
3. Create a MySQL database and user via cPanel → MySQL Databases. Grant all privileges to the user on that database.
4. Use SSH (Terminal in cPanel) to run composer install and proceed with the installation wizard.

Application Outside public_html (Recommended for Shared Hosting)

For better security you can keep the Laravel application outside the web root and serve only its public/ directory. Choose ONE of these options — never maintain two copies of the build by hand:

1. Symlink (preferred): place the app in ~/deprixa-plus and make public_html a symlink to ~/deprixa-plus/public: ln -s ~/deprixa-plus/public ~/public_html. Everything (assets, updates, plugins) keeps working with zero extra configuration.
2. Document root: if your panel allows it, point the domain's document root directly to ~/deprixa-plus/public.
3. Separate web root (APP_PUBLIC_PATH): if you must copy the contents of public/ into public_html (no symlinks allowed), tell the application where its real web root lives by adding this line to your .env:

   APP_PUBLIC_PATH=/home/youruser/public_html

   With this set, the asset manifest is read from public_html, and software updates and plugin installs write their public assets there automatically — you will never need to copy the build manually again.

VPS (DigitalOcean, Linode, Hetzner, AWS EC2)

A VPS gives you full control and is the recommended environment for production. A basic Nginx configuration:

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/deprixa-plus/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known) {
        deny all;
    }
}

After configuring Nginx, secure your site with a free SSL certificate:

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d yourdomain.com

2.3 Step-by-Step Installation Wizard

Deprixa Plus includes a built-in installation wizard that guides you through the entire setup process. Follow these five steps in order.

1. 1

   Upload & Extract

   Upload the Deprixa Plus ZIP file to your server and extract it into your web root directory. After extraction, set the correct permissions on writable directories:

   bash Copy

   chmod -R 775 storage bootstrap/cache

2. 2

   Welcome & Requirements Check

   Open your browser and navigate to yourdomain.com/install. The wizard will automatically check your PHP version, required extensions, and folder permissions. All checks must pass before you can proceed to the next step.

3. 3

   Database Configuration

   Enter your MySQL connection details:

   • Host — usually 127.0.0.1 or localhost
   • Port — default is 3306
   • Database Name — the empty database you created
   • Username and Password

   Click "Test Connection" to verify. Then enter your company name and email address. Click "Setup Database" — the wizard imports the database schema and runs all migrations automatically.

4. 4

   Admin Account

   Create your super-admin account by entering your name, email, and a strong password. This will be your main login to manage the entire platform.

5. 5

   Preferences

   Configure your initial system preferences:

   • Language — English or Spanish
   • Timezone — select your local timezone
   • Currency — default currency for invoices and rates
   • Date Format — choose your preferred display format
   • Weight Unit — kg or lb
   • Dimension Unit — cm or in

   Optionally, check "Load demo data" to populate the system with sample shipments, clients, and rates for testing. Click "Finish" — installation is complete and you will be redirected to the login page.

2.4 Cron Job Setup

Add the following cron entry to your server. This single entry runs Laravel's task scheduler every minute, which then dispatches individual tasks at their configured intervals.

* * * * * cd /path-to-project && php artisan schedule:run >> /dev/null 2>&1

Scheduled Tasks

cPanel Setup

In cPanel, go to Cron Jobs (under Advanced). Set the interval to "Once Per Minute (* * * * *)" and paste the command:

cd /home/yourusername/public_html && php artisan schedule:run >> /dev/null 2>&1

VPS Setup

On a VPS, edit the crontab for the web server user:

sudo crontab -u www-data -e
# Add this line at the bottom:
* * * * * cd /var/www/deprixa-plus && php artisan schedule:run >> /dev/null 2>&1

2.5 Post-Install Checklist

After completing the installation wizard, go through this checklist to ensure your system is production-ready.

1. Set APP_DEBUG=false in your .env file
2. Set APP_ENV=production in your .env file
3. Configure SMTP for email delivery — go to Settings → Notifications
4. Upload your company logo — go to Settings → Branding
5. Set your company information — go to Settings → Company Profile
6. Create at least one branch — go to Settings → Branches
7. Configure at least one rate zone and rate card — go to Logistics → Rates
8. Set up cron jobs (see Section 2.4 above)
9. Create the storage symlink:
   bash Copy

   php artisan storage:link

10. Test the system: create a shipment, assign it to a driver, and verify it appears on the public tracking page

2.6 Updating to a New Version

Deprixa Plus includes a built-in update system accessible from the admin panel.

1. Go to Settings → Updates in the admin panel.
2. The system checks for new versions automatically (twice daily via the scheduled task). You can also click "Check Now" to force an immediate check.
3. If a new version is available, review the changelog and click "Apply Update". The system will download the update, back up critical files, and apply any new database migrations.

2.7 Common Installation Errors

If you encounter issues during or after installation, check this table for quick solutions.