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

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

Для корректной работы 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. Как это сделать уточните в поддержке вашего хостинг-провайдера или же на нашем форуме.

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

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

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

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

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

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

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

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

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

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

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

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

make up

docker-compose up -d

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

make shell

docker exec -it $(docker ps -q -f name=ubuntu) bash

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

npm install && composer install && npm run build

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

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

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

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

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