Документація

Встановлення магазину

П’ять кроків встановлювача у браузері: від перевірки сервера до входу в панель керування.

На цій сторінці

Магазин встановлюється через браузер: розпакуйте файли, відкрийте сайт і пройдіть п’ять кроків. Ані консоль, ані composer для цього не потрібні — усі залежності вже лежать усередині дистрибутива.

Перед початком

Приготуйте три речі:

  1. Порожню базу даних MySQL або MariaDB і доступ до неї: хост, ім’я бази, користувача та пароль. Створюється в панелі хостингу за хвилину.
  2. Домен, у якого коренем сайту призначено теку public усередині магазину.
  3. Файли магазину — архів з особистого кабінету на cartixx.com.

Розпакуйте архів у теку сайту. Якщо розпаковуєте на своєму комп’ютері й завантажуєте через FTP — завантажуйте разом із прихованими файлами: .env.example і .htaccess починаються з крапки, і файлові менеджери часто їх ховають.

Крок 1. Вимоги

Відкрийте адресу сайту в браузері — магазин сам покаже сторінку встановлення.

На першому кроці він перевіряє сервер: версію PHP, розширення, права на запис. Навпроти кожного пункту стоїть позначка або хрестик, а поруч — що саме не так. Доки є хоч один хрестик, кнопка «Почати встановлення» не працює: іти далі немає сенсу, встановлення все одно обірветься посередині.

Що робити з червоними пунктами, описано на сторінці Вимоги до сервера.

Крок 2. База даних

Введіть доступ до бази й адресу сайту. Магазин перевіряє підключення одразу та повідомляє, якщо щось не сходиться.

Якщо в базі вже є таблиці, встановлювач покаже їхню кількість і зупиниться: ставитися можна лише в порожню базу. У вас два виходи — створити нову базу або позначити галочку очищення. Галочка видаляє з бази всі таблиці, тому магазин запитує окремо й показує ім’я бази: помилитися базою простіше, ніж здається.

На цьому кроці магазин записує файл .env, створює таблиці та заповнює довідники — це найдовша частина, близько хвилини.

Крок 3. Адміністратор

Створіть обліковий запис власника магазину: ім’я, пошта, пароль не коротший за вісім символів. Під ним ви увійдете до панелі керування; решту співробітників заведете вже всередині, кожного зі своїми правами.

Крок 4. Ліцензія

Введіть ліцензійний ключ з особистого кабінету на cartixx.com. Ключ можна пропустити — магазин працюватиме й без нього, але оновлення та каталог доповнень залишаться недоступними, доки ви не введете ключ у розділі «Системний» → «Ліцензія».

Крок 5. Готово

Останній екран показує те, що лишилося зробити на сервері.

Рядок планувальника. Єдине, що треба додати руками:

* * * * * cd /шлях/до/магазину && php artisan schedule:run

Шлях встановлювач підставить сам — скопіюйте рядок повністю. Подробиці на сторінці Обслуговування.

Правило веб-сервера. Встановлювач покаже рядок try_files для nginx і попросить переконатися, що він є в налаштуваннях сайту. Зазвичай він уже стоїть.

Доступ до фотографій. Посилання на сховище магазин створює сам. Якщо хостинг забороняє такі посилання, ви побачите команду php artisan storage:link — виконайте її в теці магазину, інакше фотографії товарів не відкриватимуться.

Далі натискайте «Перейти до панелі керування» і входьте під обліковим записом із третього кроку. Панель керування живе за адресою /admin.

Перші кроки в магазині

Після входу магазин запропонує майстер первинного налаштування: назва й контакти, валюта, способи доставки та оплати. Там само можна завантажити демонстраційні товари з фотографіями — зручно, щоб подивитися, як усе виглядає на вітрині, доки власного каталогу ще немає. Коли вони стануть не потрібні, видаліть їх із каталогу як звичайні товари.

Встановлювач закривається сам: після встановлення адреса /install перестає відкриватися, і запустити його повторно поверх працюючого магазину не можна.

Оновлено 7 серпня 2026