EN CS SK DE
Vexio / Dokumentácia

Dokumentácia Vexio

Kompletný sprievodca inštaláciou a konfiguráciou fakturačného systému Vexio

Vitajte vo Vexio

Vexio je profesionálna platforma pre správu faktúr a predplatného postavená na Laraveli. Umožňuje živnostníkom, agentúram a firmám vytvárať faktúry, spravovať klientov, prijímať platby a riadiť predplatné s výkonným administrátorským panelom.

Správa faktúr

Vytvárajte, odosielajte a sledujte profesionálne faktúry s automatickými pripomienkami a sledovaním stavu platieb.

Plány predplatného

Nastavte opakujúce sa plány s mesačným alebo ročným cyklom a automatickou aktiváciou.

Klientský portál

Poskytnite klientom portál na prezeranie histórie faktúr, vykonávanie platieb a správu profilu.

Viacjazyčnosť

Plná podpora 7 jazykov vrátane slovenčiny, angličtiny, češtiny, španielčiny, francúzštiny, portugalčiny a nemčiny.

Účel dokumentácie

Táto príručka pokrýva požiadavky na systém, inštalačné postupy pre cPanel a VPS prostredie, konfiguráciu a riešenie problémov platformy Vexio.

Server Požiadavky

Pred inštaláciou Vexia sa uistite, že váš server spĺňa nasledujúce minimálne požiadavky.

Softvérové požiadavky

Odporúčaný hardvér

cPanel Požiadavky

Pre inštaláciu na cPanel hostingu overte nasledujúce požiadavky:

Upozornenie - zdieľaný hosting

Niektoré zdieľané hostingy nemusia podporovať Node.js alebo SSH. Odporúčame VPS pre plnú funkčnosť. Overte u poskytovateľa pred nákupom.

VPS Požiadavky

Pre VPS inštaláciu máte plnú kontrolu nad prostredím. Odporúčame nasledujúce špecifikácie:

cPanel Inštalácia

Rýchla inštalácia (odporúčané)

Najrýchlejší spôsob inštalácie Vexia na cPanel v pouhých 3 krokoch.

Vytvorte MySQL databázu

Prejdite do cPanel → MySQL Databases. Vytvorte novú databázu a používateľa so všetkými oprávneniami. Uložte prihlasovacie údaje.

Nahrajte a nakonfigurujte .env

Nahrajte súbory Vexia do public_html (alebo priečinka subdomény). Premenujte .env.example na .env a vyplňte prihlasovacie údaje k databáze:

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ávnenia adresárov: chmod -R 775 storage/ bootstrap/cache/ cez SSH alebo cPanel File Manager.

Navštívte /install

Otvorte prehliadač a prejdite na https://yourdomain.com/install. Kliknite na tlačidlo inštalácie. Systém automaticky:

  • Vykoná databázové migrácie
  • Naimportuje predvolené údaje (admin používateľ, plány, nastavenia, e-mailové šablóny)
  • Importuje a aktivuje všetky dostupné addony
  • Vytvorí zámok inštalácie

Po dokončení sa prihláste na /login s:

Email: admin@demo.com
Heslo: 123456
Bezpečnosť

Ihneď po prvom prihlásení zmeňte predvolené administrátorské heslo!

Postupujte podľa nasledujúcich krokov pre ručnú inštaláciu Vexia na cPanel:

Vytvorte MySQL databázu

Prejdite do cPanel → MySQL Databases. Vytvorte novú databázu a používateľa so všetkými oprávneniami. Uložte prihlasovacie údaje.

Tip

Použite silné heslo. Budete ho potrebovať pre .env súbor.

Nahrajte zdrojový kód

Nahrajte Vexio ZIP archív do požadovaného adresára (public_html alebo priečinok subdomény) cez cPanel File Manager alebo FTP.

Extrahujte súbory

Kliknite pravým tlačidlom na ZIP a vyberte Extract. Uistite sa, že všetky súbory vrátane skrytých (.env.example) sú extrahované.

Nastavte oprávnenia adresárov

Nastavte správne oprávnenia pre Laravel storage a cache:

# Cez SSH terminál
chmod -R 775 storage/
chmod -R 775 bootstrap/cache/
chmod -R 775 public/uploads/

Nastavte PHP verziu

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

Nainštalujte závislosti

Cez SSH terminál spustite Composer:

# Prejdite do adresára aplikácie
cd ~/public_html
composer install --optimize-autoloader --no-dev

Ak Composer nie je cez SSH k dispozícii, spustite ho lokálne a nahrajte adresár vendor/.

Nakonfigurujte prostredie

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

cp .env.example .env

Vygenerujte aplikačný kľúč

php artisan key:generate

Spustite migrácie

php artisan migrate --force

Zostavte frontend

Nainštalujte npm balíčky a zostavte Vite:

npm install
npm run build

Vytvorte storage link

php artisan storage:link

Pristúpte k systému

Navštívte svoju doménu. Prvý registrovaný používateľ sa stáva administrátorom. Nastavenie dokončite na /admin/settings.

Bezpečnostné varovanie

Nikdy necommitnite .env súbor. Zabezpečte, aby storage/ a bootstrap/cache/ neboli verejne prístupné. Ihneď po inštalácii zmeňte predvolené prihlasovacie údaje.

VPS Inštalácia

Postupujte podľa nasledujúcich krokov pre inštaláciu Vexia na čerstvom Ubuntu 22.04/24.04 VPS:

Aktualizujte systém

Pripojte sa cez SSH a aktualizujte balíčky:

sudo apt update && sudo apt upgrade -y

Nainštalujte PHP a Extensions

# Pridanie PHP repozitára
sudo apt install -y software-properties-common
sudo add-apt-repository -y ppa:ondrej/php
sudo apt update

# Inštalácia PHP 8.4
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

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

Nainštalujte MySQL

sudo apt install -y mysql-server
sudo mysql_secure_installation

# Vytvorenie databázy
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;

Nainštalujte Nginx

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

Nainštalujte Node.js

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

Nasaďte aplikáciu

Naklonujte alebo nahrajte súbory do /var/www/vexio:

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

Nainštalujte PHP závislosti

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

Nakonfigurujte prostredie

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 kľúč a migrujte

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

Zostavte frontend

npm install
npm run build

Nastavte oprávnenia

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

Nakonfigurujte Nginx

Vytvorte 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 (alebo php8.5-fpm pre 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

Pridajte Laravel scheduler do crontab:

sudo crontab -u www-data -e

* * * * * cd /var/www/vexio && php artisan schedule:run >> /dev/null 2>&1
Inštalácia dokončená

Navštívte https://yourdomain.com. Zaregistrujte prvý účet, ktorý sa stane administrátorom. Nastavenie dokončite na /admin/settings.

Po-inštalačné kroky

Po inštalácii dokončite nasledujúce kroky:

  1. Nastavenie systému — Prejdite na /admin/settings a nastavte názov webu, logo, menu, časové pásmo a kontakty.
  2. Platobné brány — Na /admin/settings/payment-gateway nakonfigurujte Stripe, PayPal a pod.
  3. Plány predplatného — Na /admin/plans vytvorte cenové úrovne.
  4. Nastavenie pošty — SMTP nastavte v /admin/settings na odosielanie faktúr.
  5. Otestujte systém — Vytvorte testovacieho klienta, vygenerujte faktúru a overte platobný tok.
Prvý používateľ je admin

Prvý registrovaný používateľ sa automaticky stáva administrátorom s plným prístupom do administrátorského panelu.

Aktivácia licencie

Pre aktiváciu licencie Vexia zadajte nasledujúci licenčný kľúč na /license/activate.

# Licenčný kľúč:
31CB1-4F278-E94A7-A3F71
# Používateľ:
Vexio
Správa licencie

Po aktivácii môže administrátor skontrolovať stav licencie alebo ju deaktivovať pomocou tlačidla License v hornej lište admin panelu, alebo priamo:

Otvoriť /license

Demo prístup

Môžete otestovať plnú funkcionalitu Vexia pomocou demo prostredia nižšie.

Demo URL: https://vexio.ooguy.com/login
E-mail: admin@demo.com
Heslo: 123456
Bezpečnostné upozornenie

Po prvom prihlásení si ihneď zmeňte heslo. Tieto údaje sú určené len na testovanie.

Konfigurácia prostredia

Súbor .env obsahuje základnú konfiguráciu. Kľúčové premenné:

Databáza

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

Aplikácia

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

Mail Konfigurácia

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čnosť

V produkcii nastavte APP_DEBUG=false. Nikdy nezverejňujte .env. Pridajte ho do .gitignore.

Administrátorský panel

Nakonfigurujte systém cez administrátorský panel na /admin po prihlásení prvým účtom.

Branding

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

Platobné brány

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

Plány predplatného

Vytvorte cenové plány s mesačným/ročným cyklom na /admin/plans.

Mail šablóny

Upravte e-mailové šablóny pre faktúry a notifikácie na /admin/mail-templates.

Telegram integrácia

Nastavte Telegram bota pre real-time notifikácie na /admin/telegram.

Lokalizácia

Nastavte časové pásmo, formát dátumu, menu a spravujte preklady pre 7 jazykov.

Technická podpora

Náš tím podpory je pripravený pomôcť s akýmikoľvek otázkami alebo problémami týkajúcimi sa Vexia.

Potrebujete podporu?

Kontaktujte náš tím technickej podpory. Odpovieme čo najrýchlejšie!

phplicenser@gmail.com

Pracovná doba

Pondelok až piatok, 9:00–18:00 (SEČ)

Doba odozvy

Odpovedáme do 24 pracovných hodín

Dokumentácia

Než nás kontaktujete, preštudujte si túto dokumentáciu

Než nás kontaktujete

Poskytnite podrobnosti o probléme, vrátane chybových hlásení, serverových logov, Laravel logov (storage/logs/laravel.log) a kroku inštalácie, kde problém nastal.

Najčastejšie otázky (FAQ)

Je možné Vexio nainštalovať na zdieľaný hosting?

Áno, ak váš hosting podporuje PHP 8.4+, Composer, MySQL a SSH. Pre najlepší výkon odporúčame VPS.

Ako aktualizovať Vexio?

Zálohujte databázu a súbory, nahraďte novou verziou, spustite composer install --no-dev, npm install && npm run build, php artisan migrate --force, php artisan optimize:clear.

Je SSL vyžadované?

Áno, SSL je potrebné pre bezpečné spracovanie platieb a Telegram API integráciu.

Akého VPS poskytovateľa odporúčate?

Odporúčame DigitalOcean, Vultr, Linode alebo Hetzner. Zvoľte plán s minimálne 2 GB RAM.

Čo mám poslať pri žiadosti o podporu?

Pošlite chybové hlásenie, Laravel logy (storage/logs/laravel.log), detaily serveru a krok, kde problém nastáva.