Установка и системные требования

Системные требования

Для корректной работы JohnCMS, на хостинге, который вы используете, должно быть установлено следующее программное обеспечение

  • Nginx + php-fpm или Apache

  • PHP 8.0 и выше

  • MySQL 5.7 и выше или MariaDB 10.2 или выше

  • Для работы с MуSQL должен использоваться встроенный драйвер MySQL Native Driver (mysqlnd)

Для работы системы требуются следующие расширения php:

  • imagick или gd

  • mbstring

  • pdo

  • simplexml

Хостинг должен позволять указать в качестве корневой директории папку public. Обычно хостинги позволяют это сделать. Уточните этот момент у вашего хостинг-провайдера.

Установка

  • Скачиваем архив

  • Распаковываем архив в папку выше уровня корневой. Таким образом, чтобы корневой папкой была папка public. Как это сделать уточните в поддержке вашего хостинг-провайдера или же на нашем форуме.

  • Перейдите на главную страницу вашего сайта (вы будете переадресованы на страницу установки).

  • Следуйте инструкциям описанным на странице установки

Обязательно указывайте существующий e-mail адрес при установке т.к. он будет использоваться для отправки e-mail.

Установка для разработки

Данный метод подойдет если вы хотите использовать последнюю версию системы из репозитория не дожидаясь полных релизов. Данный не рекомендуется использовать для рабочих проектов т.к. версия в репозитории может иметь ошибки и незавершенные доработки.

Есть несколько вариантов установки системы локально.

  1. Установка и настройка локального окружения

  2. Установка в Docker (рекомендуется)

Установка и настройка локального окружения

Данный способ подойдет если вы устанавливаете все окружение самостоятельно. Помимо описанного в системных требованиях программного обеспечения вам потребуется Nodejs, GIT, composer.

Склонируйте или скачайте репозиторий в нужную папку. Например так:

git clone https://github.com/johncms/johncms.git johncms
cd johncms

Установите и настройте окружение так, чтобы корневой папкой домена была папка public в корне проекта, который вы склонировали.

Установите зависимости выполнив поочередно следующие команды в консоли.

composer install
npm install
npm run build

После выполнения этих команд, откройте ваш сайт в браузере и следуйте инструкциям установщика.

Если вы используете операционную систему linux или macos, можете выполнить команду make cms-install вместо описанных выше команд.

Установка в Docker (рекомендуется)

Установка с помощью Docker не требует от вас специальных знаний по настройке окружения. Все что вам потребуется, это Docker и GIT.

Склонируйте или скачайте репозиторий.

git clone https://github.com/johncms/johncms.git johncms
cd johncms

Запустите контейнер (при первом запуске произойдет скачивание и сборка контейнера, а последующие запуски будут происходить быстрее).

make up

Передите в консоль контейнера с помощью следующей команды:

make shell

После того как откроется консоль контейнера выполните следующую команду:

npm install && composer install && npm run build

Откройте браузер и установите систему.

Ваш сайт будет доступен по адресу http://localhost:8000

При установке вам потребуются данные для подключения к БД. Используйте следующие данные:

DB Host: mariadb DB Name: johncms DB User: johncms DB Password: password

Больше никаких настроек выполнять не требуется.

Last updated