Vexio Dokumentation

Willkommen bei Vexio

Vexio ist eine professionelle Plattform für Rechnungs- und Abonnementverwaltung, entwickelt mit Laravel. Sie ermöglicht Freiberuflern, Agenturen und Unternehmen, Rechnungen zu erstellen, Kunden zu verwalten, Zahlungen zu akzeptieren und Abonnements mit einem leistungsstarken Admin-Panel zu verwalten.

Server Anforderungen

Stellen Sie vor der Installation von Vexio sicher, dass Ihr Server die folgenden Mindestanforderungen erfüllt. Diese sind für den ordnungsgemäßen Betrieb der Anwendung erforderlich.

Software Anforderungen

• PHPVersion 8.4 oder höher (empfohlen: 8.5+)
• ComposerVersion 2.x (PHP-Abhängigkeitsverwaltung)
• DatenbankMySQL 8.0+ oder MariaDB 10.5+
• WebserverApache mit mod_rewrite oder Nginx
• Node.jsVersion 18+ (erforderlich für Vite-Asset-Kompilierung)
• NPMVersion 9+ (in Node.js enthalten)
• PHP-ErweiterungenBCMath, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML, GD, Curl
• SSL/HTTPSGültiges SSL-Zertifikat für sichere Verbindungen

Empfohlene Hardware

• RAMMindestens 2 GB (empfohlen: 4 GB+)
• SpeicherMindestens 10 GB freier Festplattenspeicher
• CPUMindestens 2 Kerne

cPanel Anforderungen

Für die Installation auf cPanel-basiertem Hosting prüfen Sie bitte die folgenden Punkte:

• PHP-VersioncPanel PHP Selector mit PHP 8.4+ aktiviert
• PHP-ErweiterungenDie erforderlichen PHP-Erweiterungen müssen über den PHP Selector aktiviert werden
• MySQL-DatenbankMöglichkeit zur Erstellung von Datenbanken und Benutzern
• SSH-ZugriffTerminalzugriff oder Composer-Verfügbarkeit
• Node.jsNode.js-App einrichten oder SSH-basiertes Node.js
• Domain/SubdomainDomain oder Subdomain, die auf den Server zeigt
• SSL-ZertifikatLet's Encrypt über cPanel oder installiertes Zertifikat

VPS Anforderungen

Bei der VPS-Installation haben Sie die volle Kontrolle über die Umgebung. Wir empfehlen die folgenden Spezifikationen:

• BetriebssystemUbuntu 22.04/24.04 LTS oder Debian 12
• Root-ZugriffRoot- oder sudo-Berechtigungen erforderlich
• CPUMindestens 2 Kerne (empfohlen: 4)
• RAMMindestens 2 GB (empfohlen: 4 GB+)
• WebserverNginx oder Apache
• DatenbankMySQL 8.0+ oder MariaDB 10.5+
• PHPPHP 8.4+ mit erforderlichen Erweiterungen (unterstützt 8.5)
• FirewallUFW oder 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/

# Zum App-Verzeichnis navigieren
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

Befolgen Sie die folgenden Schritte, um Vexio auf einem frischen Ubuntu 22.04/24.04 VPS zu installieren:

sudo apt update && sudo apt upgrade -y

# PHP-Repository hinzufügen
sudo apt install -y software-properties-common
sudo add-apt-repository -y ppa:ondrej/php
sudo apt update

# PHP 8.4 installieren (Minimum) oder PHP 8.5 (empfohlen)
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
# Für PHP 8.5 ersetzen Sie 8.4 durch 8.5 in den Paketnamen
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

# Datenbank erstellen
sudo mysql -u root -p

-- In 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

Nach der Installation

Nach der Installation führen Sie bitte die folgenden Schritte aus, um Ihre Vexio-Instanz zu konfigurieren:

1. Systemeinstellungen konfigurieren — Gehen Sie zu /admin/settings, um Seitenname, Logo, Währung, Zeitzone und Kontaktinformationen festzulegen.
2. Zahlungsgateways einrichten — Navigieren Sie zu /admin/settings/payment-gateway, um Stripe, PayPal usw. zu konfigurieren.
3. Abonnementpläne erstellen — Gehen Sie zu /admin/plans, um Preisstufen einzurichten.
4. Mail-Einstellungen konfigurieren — Richten Sie SMTP unter /admin/settings ein, um Rechnungen zu versenden.
5. System testen — Erstellen Sie einen Testkunden, generieren Sie eine Rechnung und überprüfen Sie den Zahlungsablauf.

Lizenzaktivierung

Um Ihre Vexio-Lizenz zu aktivieren, geben Sie den folgenden Lizenzschlüssel unter /license/activate ein.

# Lizenzschlüssel:
31CB1-4F278-E94A7-A3F71
# Benutzer:
Vexio

Demo-Zugang

Sie können die volle Funktionalität von Vexio mit der folgenden Demo-Umgebung testen.

Demo-URL: https://vexio.ooguy.com/login
E-Mail:: admin@demo.com
Passwort: 123456

Umgebungs-Konfiguration

Die .env-Datei enthält die wesentliche Konfiguration. Wichtige Variablen:

Datenbank-Einstellungen

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

Anwendungs-Einstellungen

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

Mail-Konfiguration

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 Einrichtung

Konfigurieren Sie Ihr System über das Admin-Panel unter /admin, nachdem Sie sich mit dem ersten registrierten Konto angemeldet haben.

Technischer Support

Unser Support-Team hilft Ihnen gerne bei Fragen oder Problemen rund um Vexio.

Häufig gestellte Fragen (FAQ)