Instalace

Laravix je self-hosted multi-tenant CMS postavený na Laravelu a Filamentu. Tento návod vás provede od prázdného adresáře k běžící administraci přes oficiální distribuci — bez Node.js a bez buildování assetů.

Požadavky#

• PHP 8.4 s rozšířením fileinfo (a gd, pokud chcete automatické zmenšování obrázků)
• Composer
• Databáze: SQLite (bez konfigurace, doporučeno na start), MySQL/MariaDB nebo PostgreSQL
• Webový server mířící na public/ (lokálně stačí php artisan serve)

1. Vytvoření projektu#

composer create-project laravix/laravix my-site
cd my-site

Tím vznikne Laravel aplikace s nainstalovaným balíčkem laravix/cms a vyřešenými závislostmi.

2. Spuštění instalátoru#

php artisan laravix:install

Interaktivní instalátor vás provede vším:

1. Databáze — pokud nakonfigurovaná databáze není dostupná, nabídne SQLite, MySQL/MariaDB nebo PostgreSQL a přihlašovací údaje za vás zapíše do .env.
2. Migrace a storage — spustí migrace a storage:link.
3. Assety a šablona — publikuje assety administrace, konfigurační soubor a výchozí šablonu do themes/default.
4. První web — zeptá se na název webu a doménu. Web se vytvoří v režimu šablony s výchozí šablonou.
5. Super admin — zeptá se na jméno, e-mail a heslo (minimálně 8 znaků) účtu, kterým se budete přihlašovat.
6. Demo obsah — volitelně naseeduje ukázkovou úvodní stránku, příspěvky a kategorie, aby web nebyl prázdný.

Očekávaný výsledek: přehledový box s URL webu, URL administrace a přihlašovacím e-mailem.

Neinteraktivní instalace#

Každý dotaz má svůj přepínač, takže instalátor funguje i ve skriptech:

php artisan laravix:install \
  --site-name="Můj web" \
  --domain=muj-web.test \
  --admin-name="Jana Nováková" \
  [email protected] \
  --admin-password=tajne-heslo \
  --demo \
  --no-interaction

Pokud už nějaké weby existují, instalátor odmítne běžet — přidejte --force, chcete-li ho spustit i tak.

3. Přihlášení#

Otevřete https://vase-domena/admin (s php artisan serve pak http://localhost:8000/admin) a přihlaste se super admin účtem. Veřejný web odpovídá na doméně zadané u webu — Laravix hledá web podle hostname požadavku, takže doména v administraci musí odpovídat adrese, kterou prohlížíte.

Tip: Pro lokální vývoj použijte doménu typu muj-web.test mířící na váš stroj a přesně tu zadejte jako doménu webu.

Řešení problémů#

Frontend vrací 404 na všechno. Hostname požadavku neodpovídá doméně žádného webu. Zkontrolujte doménu webu v administraci (přepínač vlevo nahoře → váš web), případně jako super admin v sekci Weby.

Obrázky se nahrají, ale zmenšené varianty se neobjeví. Varianty generuje úloha ve frontě. Buď spusťte worker (php artisan queue:work), nebo pro malé weby nastavte QUEUE_CONNECTION=sync. Viz Nasazení do produkce.

Naplánovaný obsah se nikdy nepublikuje. Neběží Laravel scheduler. Přidejte cron záznam z článku Nasazení do produkce.

Související články#

• Nasazení do produkce — produkční checklist (cron, fronta, cache)
• Lokální vývoj (monorepo) — přispívání do samotného Laravixu
• Aktualizace