Vexio Documentation

Welcome to Vexio

Vexio is a professional invoicing and subscription management platform built with Laravel. It enables freelancers, agencies, and businesses to create invoices, manage clients, accept payments, and handle subscriptions with a powerful admin panel.

Server Requirements

Before installing Vexio, ensure your server meets the following minimum requirements. These are essential for the application to run correctly.

Software Requirements

• PHPVersion 8.4 or higher (recommended: 8.5+)
• ComposerVersion 2.x (PHP dependency manager)
• DatabaseMySQL 8.0+ or MariaDB 10.5+
• Web ServerApache with mod_rewrite or Nginx
• Node.jsVersion 18+ (required for Vite asset compilation)
• NPMVersion 9+ (included with Node.js)
• PHP ExtensionsBCMath, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML, GD, Curl
• SSL/HTTPSValid SSL certificate for secure connections

Recommended Hardware

• RAMMinimum 2GB (recommended: 4GB+)
• StorageMinimum 10GB free disk space
• CPUMinimum 2 cores

cPanel Requirements

For installation on cPanel-based hosting, verify the following items are available:

• PHP VersioncPanel PHP Selector with PHP 8.4+ enabled
• PHP ExtensionsThe required PHP extensions must be enabled via PHP Selector
• MySQL DatabaseAbility to create databases and users
• SSH AccessTerminal access or Composer availability
• Node.jsSetup Node.js app or SSH-based Node.js
• Domain/SubdomainDomain or subdomain pointed to the server
• SSL CertificateLet's Encrypt via cPanel or installed certificate

VPS Requirements

For VPS installation, you have full control over the environment. We recommend the following specifications:

• OSUbuntu 22.04/24.04 LTS or Debian 12
• Root AccessRoot or sudo privileges required
• CPUMinimum 2 cores (recommended: 4)
• RAMMinimum 2GB (recommended: 4GB+)
• Web ServerNginx or Apache
• DatabaseMySQL 8.0+ or MariaDB 10.5+
• PHPPHP 8.4+ with required extensions (supports 8.5)
• FirewallUFW or iptables (ports 80, 443, 22)

cPanel Installation

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_database_user
DB_PASSWORD=your_database_password

Email: admin@demo.com
Password: 123456

# Via SSH terminal
chmod -R 775 storage/
chmod -R 775 bootstrap/cache/
chmod -R 775 public/uploads/

# Navigate to the app directory
cd ~/public_html
composer install --optimize-autoloader --no-dev

cp .env.example .env

php artisan key:generate

php artisan migrate --force

npm install
npm run build

php artisan storage:link

VPS Installation

Follow the steps below to install Vexio on a fresh Ubuntu 22.04/24.04 VPS:

sudo apt update && sudo apt upgrade -y

# Add PHP repository
sudo apt install -y software-properties-common
sudo add-apt-repository -y ppa:ondrej/php
sudo apt update

# Install PHP 8.4 (minimum) or PHP 8.5 (recommended)
sudo apt install -y php8.4 php8.4-cli php8.4-common php8.4-mysql php8.4-xml php8.4-mbstring php8.4-curl php8.4-gd php8.4-bcmath php8.4-zip php8.4-fpm
# For PHP 8.5, replace 8.4 with 8.5 in the package names
sudo apt install -y php8.5 php8.5-cli php8.5-common php8.5-mysql php8.5-xml php8.5-mbstring php8.5-curl php8.5-gd php8.5-bcmath php8.5-zip php8.5-fpm

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
php -r "unlink('composer-setup.php');"

sudo apt install -y mysql-server
sudo mysql_secure_installation

# Create database
sudo mysql -u root -p

-- Inside MySQL:
CREATE DATABASE vexio CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'vexio'@'localhost' IDENTIFIED BY 'strong_password';
GRANT ALL PRIVILEGES ON vexio.* TO 'vexio'@'localhost';
FLUSH PRIVILEGES;
EXIT;

sudo apt install -y nginx
sudo systemctl enable nginx
sudo systemctl start nginx

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node --version

sudo mkdir -p /var/www/vexio
sudo chown -R $USER:$USER /var/www/vexio
git clone [repo] /var/www/vexio

cd /var/www/vexio
composer install --optimize-autoloader --no-dev

cp .env.example .env
nano .env

APP_NAME=Vexio
APP_ENV=production
APP_DEBUG=false
APP_URL=https://yourdomain.com

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=vexio
DB_USERNAME=vexio
DB_PASSWORD=strong_password

php artisan key:generate
php artisan migrate --force
php artisan storage:link

npm install
npm run build

sudo chown -R www-data:www-data storage/ bootstrap/cache/ public/uploads/
sudo chmod -R 775 storage/ bootstrap/cache/ public/uploads/

sudo nano /etc/nginx/sites-available/vexio

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

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

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.4-fpm.sock (or php8.5-fpm for PHP 8.5);
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht { deny all; }
    location ~ \.env { deny all; }
}

sudo ln -s /etc/nginx/sites-available/vexio /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com
sudo certbot renew --dry-run

sudo apt install -y supervisor
sudo nano /etc/supervisor/conf.d/vexio-worker.conf

[program:vexio-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/vexio/artisan queue:work --sleep=3 --tries=3 --max-time=3600
autostart=true
autorestart=true
user=www-data
numprocs=2
redirect_stderr=true
stdout_logfile=/var/www/vexio/storage/logs/worker.log

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start vexio-worker:*

sudo crontab -u www-data -e

* * * * * cd /var/www/vexio && php artisan schedule:run >> /dev/null 2>&1

Post-Installation Steps

After installation, complete the following to configure your Vexio instance:

1. Configure System Settings — Go to /admin/settings to set site name, logo, currency, timezone, and contact info.
2. Set Up Payment Gateways — Navigate to /admin/settings/payment-gateway to configure Stripe, PayPal, etc.
3. Create Subscription Plans — Go to /admin/plans to set up pricing tiers.
4. Configure Mail Settings — Set up SMTP in /admin/settings for sending invoices.
5. Test the System — Create a test client, generate an invoice, and verify the payment flow.

License Activation

To activate your Vexio license, enter the following license key at /license/activate.

# License Key:
31CB1-4F278-E94A7-A3F71
# User:
Vexio

Demo Access

You can test the full functionality of Vexio using the demo environment below.

Demo URL: https://vexio.ooguy.com/login
Email: admin@demo.com
Password: 123456

Environment Configuration

The .env file contains essential configuration. Key variables:

Database Settings

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=vexio
DB_USERNAME=vexio_user
DB_PASSWORD=your_secure_password

Application Settings

APP_NAME=Vexio
APP_ENV=production
APP_DEBUG=false
APP_URL=https://yourdomain.com

Mail Configuration

MAIL_MAILER=smtp
MAIL_HOST=smtp.yourprovider.com
MAIL_PORT=587
MAIL_USERNAME=your@email.com
MAIL_PASSWORD=your_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=noreply@yourdomain.com
MAIL_FROM_NAME=${APP_NAME}

Admin Panel Setup

Configure your system through the admin panel at /admin after logging in with the first registered account.

Technical Support

Our support team is ready to help with any questions or issues related to Vexio.

Frequently Asked Questions (FAQ)