EN CS SK DE
Vexio / Dokumentace

Dokumentace Vexio

Kompletní průvodce instalací a konfigurací fakturačního systému Vexio

Vítejte ve Vexio

Vexio je profesionální platforma pro správu faktur a předplatného postavená na Laravelu. Umožňuje živnostníkům, agenturám a firmám vytvářet faktury, spravovat klienty, přijímat platby a řídit předplatné s výkonným administrátorským panelem.

Správa faktur

Vytvářejte, odesílejte a sledujte profesionální faktury s automatickými připomínkami a sledováním stavu plateb.

Plány předplatného

Nastavte opakující se plány s měsíčním nebo ročním cyklem a automatickou aktivací.

Klientský portál

Poskytněte klientům portál pro prohlížení historie faktur, provádění plateb a správu profilu.

Vícejazyčnost

Plná podpora 7 jazyků včetně češtiny, angličtiny, slovenštiny, španělštiny, francouzštiny, portugalštiny a němčiny.

Účel dokumentace

Tato příručka pokrývá požadavky na systém, instalační postupy pro cPanel a VPS prostředí, konfiguraci a řešení problémů platformy Vexio.

Server Požadavky

Před instalací Vexia se ujistěte, že váš server splňuje následující minimální požadavky.

Software Požadavky

Doporučený hardware

cPanel Požadavky

Pro instalaci na cPanel hostingu ověřte následující požadavky:

Upozornění - sdílený hosting

Některé sdílené hostingy nemusí podporovat Node.js nebo SSH. Doporučujeme VPS pro plnou funkčnost. Ověřte u poskytovatele před nákupem.

VPS Požadavky

Pro VPS instalaci máte plnou kontrolu nad prostředím. Doporučujeme následující specifikace:

cPanel Instalace

Rychlá instalace (doporučeno)

Nejrychlejší způsob instalace Vexia na cPanel v pouhých 3 krocích.

Vytvořte MySQL databázi

Přejděte do cPanel → MySQL Databases. Vytvořte novou databázi a uživatele se všemi oprávněními. Uložte přihlašovací údaje.

Nahrajte a nakonfigurujte .env

Nahrajte soubory Vexia do public_html (nebo složky subdomény). Přejmenujte .env.example na .env a vyplňte přihlašovací údaje k databázi: 

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

Nastavte oprávnění adresářů: chmod -R 775 storage/ bootstrap/cache/ přes SSH nebo cPanel File Manager.

Navštivte /install

Otevřete prohlížeč a přejděte na https://yourdomain.com/install. Klikněte na tlačítko instalace. Systém automaticky:

  • Provede databázové migrace
  • Naimportuje výchozí data (admin uživatel, plány, nastavení, e-mailové šablony)
  • Importuje a aktivuje všechny dostupné addony
  • Vytvoří zámek instalace

Po dokončení se přihlaste na /login s:

Email: admin@demo.com
Heslo: 123456
Bezpečnost

Ihned po prvním přihlášení změňte výchozí administrátorské heslo!

Postupujte podle následujících kroků pro ruční instalaci Vexia na cPanel:

Vytvořte MySQL databázi

Přejděte do cPanel → MySQL Databases. Vytvořte novou databázi a uživatele se všemi oprávněními. Uložte přihlašovací údaje.

Tip

Použijte silné heslo. Budete je potřebovat pro .env soubor.

Nahrajte zdrojový kód

Nahrajte Vexio ZIP archiv do požadovaného adresáře (public_html nebo složka subdomény) přes cPanel File Manager nebo FTP.

Extrahujte soubory

Klikněte pravým tlačítkem na ZIP a vyberte Extract. Ujistěte se, že všechny soubory včetně skrytých (.env.example) jsou extrahovány.

Nastavte oprávnění adresářů

Nastavte správná oprávnění pro Laravel storage a cache:

# Přes SSH terminál
chmod -R 775 storage/
chmod -R 775 bootstrap/cache/
chmod -R 775 public/uploads/

Nastavte PHP verzi

V cPanel → PHP Selector nastavte PHP na verzi 8.4 nebo vyšší. Povolte extensions: BCMath, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML, GD, Curl.

Nainstalujte závislosti

Přes SSH terminál spusťte Composer:

# Přejděte do adresáře aplikace
cd ~/public_html
composer install --optimize-autoloader --no-dev

Pokud Composer není přes SSH k dispozici, spusťte jej lokálně a nahrajte adresář vendor/.

Nakonfigurujte prostředí

Zkopírujte .env.example na .env a upravte:

cp .env.example .env

Vygenerujte aplikační klíč

php artisan key:generate

Spusťte migrace

php artisan migrate --force

Sestavte frontend

Nainstalujte npm balíčky a sestavte Vite:

npm install
npm run build

Vytvořte storage link

php artisan storage:link

Přistupte k systému

Navštivte svou doménu. První registrovaný uživatel se stává administrátorem. Nastavení dokončete na /admin/settings.

Bezpečnostní varování

Nikdy necommitujte .env soubor. Zajistěte, aby storage/ a bootstrap/cache/ nebyly veřejně přístupné. Ihned po instalaci změňte výchozí přihlašovací údaje.

VPS Instalace

Postupujte podle následujících kroků pro instalaci Vexia na čerstvém Ubuntu 22.04/24.04 VPS:

Aktualizujte systém

Připojte se přes SSH a aktualizujte balíčky:

sudo apt update && sudo apt upgrade -y

Nainstalujte PHP a Extensions

# Přidání PHP repozitáře
sudo apt install -y software-properties-common
sudo add-apt-repository -y ppa:ondrej/php
sudo apt update

# Instalace PHP 8.4 (minimální) nebo PHP 8.5 (doporučeno)
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
# Pro PHP 8.5 nahraďte 8.4 za 8.5 v názvech balíčků
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

Nainstalujte Composer

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');"

Nainstalujte MySQL

sudo apt install -y mysql-server
sudo mysql_secure_installation

# Vytvoření databáze
sudo mysql -u root -p

-- V 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;

Nainstalujte Nginx

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

Nainstalujte Node.js

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

Nasaďte aplikaci

Naklonujte nebo nahrajte soubory do /var/www/vexio:

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

Nainstalujte PHP závislosti

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

Nakonfigurujte prostředí

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

Generujte klíč a migrujte

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

Sestavte frontend

npm install
npm run build

Nastavte oprávnění

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

Nakonfigurujte Nginx

Vytvořte Nginx server blok:

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 (nebo php8.5-fpm pro 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

SSL certifikát

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

Queue Worker

Nastavte Laravel queue worker:

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:*

Cron job

Přidejte Laravel scheduler do crontab:

sudo crontab -u www-data -e

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

Navštivte https://yourdomain.com. Zaregistrujte první účet, který se stane administrátorem. Nastavení dokončete na /admin/settings.

Post-Instalační kroky

Po instalaci dokončete následující kroky:

  1. Nastavení systému — Přejděte na /admin/settings a nastavte název webu, logo, měnu, časové pásmo a kontakty.
  2. Platební brány — Na /admin/settings/payment-gateway nakonfigurujte Stripe, PayPal apod.
  3. Plány předplatného — Na /admin/plans vytvořte cenové úrovně.
  4. Nastavení pošty — SMTP nastavte v /admin/settings pro odesílání faktur.
  5. Otestujte systém — Vytvořte testovacího klienta, vygenerujte fakturu a ověřte platební tok.
První uživatel je admin

První registrovaný uživatel se automaticky stává administrátorem s plným přístupem do administrátorského panelu.

Aktivace licence

Pro aktivaci licence Vexia zadejte následující licenční klíč na /license/activate.

# Licenční klíč:
31CB1-4F278-E94A7-A3F71
# Uživatel:
Vexio
Správa licence

Po aktivaci může administrátor zkontrolovat stav licence nebo ji deaktivovat pomocí tlačítka License v horní liště admin panelu, nebo přímo:

Otevřít /license

Demo přístup

Můžete otestovat plnou funkčnost Vexia pomocí demo prostředí níže.

Demo URL: https://vexio.ooguy.com/login
E-mail: admin@demo.com
Heslo: 123456
Bezpečnostní upozornění

Po prvním přihlášení si ihned změňte heslo. Tyto údaje jsou určeny pouze pro testování.

Environment Konfigurace

Soubor .env obsahuje základní konfiguraci. Klíčové proměnné:

Databáze

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

Aplikace

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

Mail Konfigurace

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}
Bezpečnost

V produkci nastavte APP_DEBUG=false. Nikdy nezveřejňujte .env. Přidejte jej do .gitignore.

Administrátorský panel

Nakonfigurujte systém přes administrátorský panel na /admin po přihlášení prvním účtem.

Branding

Nahrajte logo, faviconu, nastavte název webu na /admin/settings.

Platební brány

Nakonfigurujte Stripe, PayPal, Razorpay, Mollie na /admin/settings/payment-gateway.

Plány předplatného

Vytvořte cenové plány s měsíčním/ročním cyklem na /admin/plans.

Mail šablony

Upravte e-mailové šablony pro faktury a notifikace na /admin/mail-templates.

Telegram integrace

Nastavte Telegram bota pro real-time notifikace na /admin/telegram.

Lokalizace

Nastavte časové pásmo, formát data, měnu a spravujte překlady pro 7 jazyků.

Technická podpora

Náš tým podpory je připraven pomoci s jakýmikoli dotazy nebo problémy týkajícími se Vexia.

Potřebujete podporu?

Kontaktujte náš tým technické podpory. Odpovíme co nejrychleji!

phplicenser@gmail.com

Pracovní doba

Pondělí až pátek, 9:00–18:00 (SEČ)

Doba odezvy

Odpovídáme do 24 pracovních hodin

Dokumentace

Než nás kontaktujete, prostudujte si tuto dokumentaci

Než nás kontaktujete

Poskytněte podrobnosti o problému, včetně chybových hlášení, serverových logů, Laravel logů (storage/logs/laravel.log) a kroku instalace, kde problém nastal.

Nejčastější dotazy (FAQ)

Lze Vexio nainstalovat na sdílený hosting?

Ano, pokud váš hosting podporuje PHP 8.4+, Composer, MySQL a SSH. Pro nejlepší výkon doporučujeme VPS.

Jak aktualizovat Vexio?

Zálohujte databázi a soubory, nahraďte novou verzí, spusťte composer install --no-dev, npm install && npm run build, php artisan migrate --force, php artisan optimize:clear.

Je SSL vyžadováno?

Ano, SSL je nutné pro bezpečné zpracování plateb a Telegram API integraci.

Jakého VPS poskytovatele doporučujete?

Doporučujeme DigitalOcean, Vultr, Linode nebo Hetzner. Zvolte plán s minimálně 2 GB RAM.

Co mám poslat při žádosti o podporu?

Pošlete chybové hlášení, Laravel logy (storage/logs/laravel.log), detaily serveru a krok, kde problém nastává.