Установка Joomla: пошаговый рецепт от нуля до рабочего сайта

Диагноз

Скачал Joomla. Залил на хостинг. Открыл браузер — белый экран. Или ошибка базы данных. Или установщик завис на последнем шаге и молчит. Знакомо?

Большинство мануалов по Joomla написаны либо в 2015-м, либо людьми, которые ни разу не устанавливали её на живой хостинг. В итоге ты тыкаешься в интерфейс вслепую, гуглишь каждую ошибку отдельно, и в итоге либо бросаешь, либо кое-как делаешь — а потом оно «само ломается».

Эта статья — другая. Здесь ты получишь рабочий сайт на Joomla 4 за 30–40 минут. Без воды, без «а вот ещё один способ». Один путь — правильный.

Что тебе понадобится:

• Хостинг с PHP 8.1+ и MySQL 8.0 / MariaDB 10.4+
• Доступ по FTP или файловый менеджер в панели хостинга
• Панель управления базами данных (phpMyAdmin или аналог)
• 30–40 минут и стакан чего-нибудь горячего

Что будет в статье:

• Подготовка хостинга и базы данных
• Скачивание и заливка Joomla
• Прохождение установщика без ошибок
• Первые шаги в админке: шаблоны, модули, компоненты, меню
• Установка расширений и плагинов
• Топ-5 ошибок и как их лечить
• Профилактика: чтобы не сломалось снова

Почему болит: топ причин, по которым Joomla не встаёт или падает

1. Неправильная версия PHP

Joomla 4 требует PHP 8.1 или выше. Если хостинг по умолчанию даёт PHP 7.4 — установщик либо падает с ошибкой, либо устанавливается, но потом всё странно глючит. Это первое, что проверяем.

2. База данных создана без нужных прав

Частая история: базу создали, пользователя создали, а права назначить забыли. Установщик пишет «не могу подключиться» — и ты час смотришь на правильные логин/пароль, не понимая, в чём дело.

3. Файлы залиты в неправильную папку

Если залить Joomla в подпапку /public_html/joomla/ вместо /public_html/ — сайт откроется по адресу site.ru/joomla/, и все пути в конфиге будут неправильными. Потом пересобирать больно.

4. Не удалили папку установщика

После установки Joomla требует удалить папку /installation/. Если не удалить — сайт работает, но при следующем запуске установщик может перезаписать конфиг. Плюс это дыра в безопасности.

5. Кодировка БД выставлена неправильно

База создана в latin1 вместо utf8mb4_unicode_ci — и ты потом разбираешься, почему кириллица в материалах отображается кракозябрами. Лечится пересозданием базы, что неприятно уже после наполнения.

Рецепт: установка Joomla от А до Я

Шаг 0. Подготовка хостинга

Проверь версию PHP

Зайди в панель управления хостингом (cPanel, ISPmanager, DirectAdmin — неважно) и найди раздел «PHP» или «Конфигурация PHP». Должна стоять версия 8.1 или выше. Если стоит 7.x — переключи.

Проверь расширения PHP

Для работы Joomla нужны расширения: mysqli, xml, json, zlib, mbstring. На большинстве хостингов они включены по умолчанию. Если нет — включи через панель или попроси поддержку.

Шаг 1. Создание базы данных

Создай базу и пользователя

В phpMyAdmin или панели хостинга создай новую базу данных. Кодировка — обязательно utf8mb4_unicode_ci.

# Если есть доступ к MySQL через консоль:
CREATE DATABASE joomla_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'joomla_user'@'localhost' IDENTIFIED BY 'СильныйПароль123!';
GRANT ALL PRIVILEGES ON joomla_db.* TO 'joomla_user'@'localhost';
FLUSH PRIVILEGES;

Запиши имя базы, логин и пароль — они понадобятся на шаге установки.

Шаг 2. Скачивание Joomla

Скачай актуальную версию

Идёшь на официальный сайт downloads.joomla.org и скачиваешь последнюю стабильную версию Joomla 4 в виде ZIP-архива. Никаких торрентов, никаких «русских сборок» — только официальный источник.

# Или через консоль (если есть SSH-доступ):
cd /tmp
wget https://downloads.joomla.org/cms/joomla4/4-4-0/Joomla_4-4-0-Stable-Full_Package.zip

После скачивания у тебя будет ZIP примерно на 20–25 МБ.

Шаг 3. Заливка файлов на хостинг

Определи правильную папку

Корневая папка сайта зависит от хостинга. Обычно это /public_html/, /www/ или /htdocs/. Уточни в документации или поддержке хостинга. Все файлы Joomla должны лежать прямо там, не в подпапке.

Загрузи и распакуй архив

Вариант 1: через файловый менеджер хостинга — загружаешь ZIP, жмёшь «Распаковать».

Вариант 2: через FTP — распаковываешь на компьютере, потом заливаешь папку содержимое архива (не саму папку!) в корень сайта.

Вариант 3: через SSH — самый быстрый.

# Через SSH (если есть доступ):
cd /var/www/html   # или /public_html — зависит от хостинга
wget https://downloads.joomla.org/cms/joomla4/4-4-0/Joomla_4-4-0-Stable-Full_Package.zip
unzip Joomla_4-4-0-Stable-Full_Package.zip
rm Joomla_4-4-0-Stable-Full_Package.zip

После распаковки в корневой папке должны появиться файлы: index.php, htaccess.txt, папки administrator/, components/, libraries/ и другие.

Шаг 4. Запуск установщика

Открой сайт в браузере

Переходи по адресу твоего сайта. Должен открыться мастер установки Joomla — синий экран с логотипом и выбором языка.

Шаг 4.1 — Основная конфигурация

Выбираешь язык интерфейса (для русского — «Russian»), вводишь название сайта, email администратора, логин и пароль администратора.

Шаг 4.2 — Подключение базы данных

Вводишь данные БД, которые записал на шаге 1:

Жмёшь «Следующий шаг». Если подключение прошло — переходишь дальше. Если ошибка — проверяй права пользователя БД (шаг 1).

Шаг 4.3 — Обзор установки

На этом экране Joomla покажет сводку всех настроек и результаты проверки сервера. Зелёные пункты — хорошо. Если что-то красное — смотришь что именно и исправляешь до продолжения.

Можно дополнительно установить демонстрационные данные — выбери «Стандартный сайт на русском», если хочешь посмотреть как выглядит заполненный сайт. Для продакшна — оставь «Нет».

Жмёшь «Установить». Процесс занимает 1–3 минуты.

Шаг 4.4 — Удаление папки установщика

После успешной установки Joomla покажет экран с кнопкой «Удалить папку установщика». Жми обязательно — без этого сайт не откроется нормально.

# Или вручную через SSH:
rm -rf /public_html/installation/

После удаления папки можешь переходить на сайт или в админку.

Шаг 5. Первые шаги в админке Joomla

Войди в административную панель

Адрес админки Joomla всегда: твойсайт.ru/administrator. Вводишь логин и пароль, которые указал при установке.

Переключи язык интерфейса на русский

По умолчанию Joomla может быть на английском. Идёшь в меню: System → Install → Languages, находишь «Russian» и устанавливаешь. Потом: System → Manage → Languages — ставишь русский как язык по умолчанию для сайта и для админки.

# Установить русский языковой пакет можно и через консоль (если используешь Joomla CLI):
php cli/joomla.php extension:install --url=https://update.joomla.org/language/details4/ru-RU_joomla_lang_full_4.x.x.zip

Выбери и установи шаблон

Joomla идёт с базовыми шаблонами оформления. Для выбора идёшь в: System → Templates → Site Templates. По умолчанию стоит Cassiopeia — современный адаптивный шаблон, нормальный старт.

Если нужен другой шаблон — скачиваешь ZIP с шаблоном и устанавливаешь через: System → Install → Extensions. Загружаешь ZIP-файл, жмёшь «Установить».

Создай первый материал (статью)

Материалы в Joomla — это страницы с контентом. Идёшь в: Content → Articles → New. Вводишь заголовок, пишешь текст, выбираешь категорию, жмёшь «Сохранить и закрыть».

Чтобы статья появилась на сайте — нужно добавить её в меню.

Настрой меню

Иди в: Menus → Main Menu → Add New Menu Item. Выбираешь тип пункта меню — например «Single Article» или «Category Blog». Привязываешь к нужному материалу или категории, вводишь заголовок пункта меню, сохраняешь.

После сохранения новый пункт должен появиться в навигации сайта.

Шаг 6. Установка расширений и плагинов

Что такое расширения в Joomla

В Joomla есть четыре типа расширений:

• Компоненты — крупные функциональные блоки (магазин, форум, галерея). Отображаются в центральной части страницы.
• Модули — небольшие блоки (меню, поиск, форма входа, последние новости). Располагаются в позициях шаблона.
• Плагины — работают в фоне, расширяют функциональность (SEF-ссылки, кэш, авторизация).
• Шаблоны — внешний вид сайта.

Установка расширения

Идёшь в: System → Install → Extensions. Три способа установки:

• Загрузить ZIP-файл с компьютера
• Установить по URL (ссылка на ZIP-архив)
• Установить из директории сервера (если уже загрузил файлы вручную)

# Через Joomla CLI можно устанавливать расширения так:
php cli/joomla.php extension:install --path=/tmp/extension.zip

Активация модуля

После установки модуль нужно не только включить, но и назначить ему позицию в шаблоне. Идёшь в: Content → Site Modules. Находишь нужный модуль, открываешь, ставишь статус «Опубликован», выбираешь позицию из списка, сохраняешь.

Управление плагинами

Плагины находятся в: System → Manage → Plugins. Включаются и отключаются одной кнопкой. Перед отключением незнакомого плагина — проверь, что он делает. Отключишь не то — сайт может перестать работать.

Шаг 7. Обновление Joomla

Проверка и установка обновлений

Joomla умеет обновляться из административной панели. Идёшь в: System → Update → Joomla. Если доступно обновление — кнопка «Update Now» активна.

Перед обновлением всегда делай бэкап — базы данных и файлов. Даже если версия меняется с 4.4.1 на 4.4.2 — всё равно. Один раз пожалеешь что не сделал, и больше не пропустишь.[/su_note>

# Обновление через Joomla CLI (доступно в Joomla 4.1+):
php cli/joomla.php core:update

После обновления проверяешь сайт визуально — главную страницу, несколько материалов, форму контактов. Если что-то сломалось — смотришь ошибки в: System → Logs → Log Files.

Осложнения: ошибки и их лечение

Ошибка 1: белый экран после установки (500 Internal Server Error)

Почему: Чаще всего — несовместимая версия PHP или ошибка в .htaccess.

Лечение: Первым делом проверяешь версию PHP и переключаешь на 8.1+. Если не помогло — переименовываешь .htaccess в .htaccess.bak и копируешь htaccess.txt в .htaccess.

# Через SSH:
cd /public_html
cp .htaccess .htaccess.bak
cp htaccess.txt .htaccess

Если ошибка осталась — включаешь отображение ошибок PHP временно и смотришь что именно падает.

# Добавь в начало index.php временно (убери после диагностики!):
ini_set('display_errors', 1);
error_reporting(E_ALL);

Ошибка 2: «Could not connect to the database» при установке

Почему: Неправильные данные БД или пользователь не имеет прав на базу.

Лечение: Проверяешь в phpMyAdmin, что пользователь существует и имеет все права на нужную базу.

# Проверь права пользователя в MySQL:
SHOW GRANTS FOR 'joomla_user'@'localhost';

# Если прав нет — добавь:
GRANT ALL PRIVILEGES ON joomla_db.* TO 'joomla_user'@'localhost';
FLUSH PRIVILEGES;

Вторая частая причина — хост базы данных. Попробуй вместо localhost вписать 127.0.0.1. На некоторых хостингах это имеет значение.

Ошибка 3: кракозябры в кириллице (вместо текста — «????» или «ÐÑеѻ)

Почему: База данных создана с неправильной кодировкой — latin1 вместо utf8mb4_unicode_ci.

Лечение до наполнения сайта: пересоздай базу с правильной кодировкой и переустанови Joomla.

Лечение после наполнения: конвертируй базу.

# Конвертация существующей базы в utf8mb4:
ALTER DATABASE joomla_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# Конвертация всех таблиц (замени префикс abc1_ на свой):
ALTER TABLE abc1_content CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
# Повтори для каждой таблицы, или используй <a class="wpil_keyword_link" href="https://it-apteka.com/category/scripts/" target="_blank"  rel="noopener" title="Скрипты" data-wpil-keyword-link="linked"  data-wpil-monitor-id="1251">скрипт</a> автоконвертации

Ошибка 4: «Установщик не удалён» / сайт просит удалить папку installation

Почему: Папка /installation/ не была удалена после установки, или кнопка в установщике не сработала.

Лечение:

# Через SSH:
rm -rf /public_html/installation/

# Через FTP: просто удали папку installation/ из корня сайта

Ошибка 5: после установки расширения сайт упал

Почему: Расширение несовместимо с версией Joomla или PHP, или конфликтует с другим расширением.

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

# Отключить расширение через MySQL (замени название расширения):
UPDATE abc1_extensions SET enabled = 0 WHERE element = 'название_расширения';

# Или отключить все плагины разом (крайний случай):
UPDATE abc1_extensions SET enabled = 0 WHERE type = 'plugin';

После отключения входишь в админку и разбираешься какое именно расширение виновато.

Профилактика: чтобы не сломалось снова

Настрой автоматический бэкап

Установи расширение Akeeba Backup — это стандарт для бэкапа в Joomla. Бесплатная версия умеет всё что нужно: бэкап файлов + БД, расписание, хранение на сервере или Google Drive.

# После <a title="Docker Compose — установка, команды и настройка контейнеров" href="https://it-apteka.com/docker-compose-ustanovka-komandy-i-nastrojka-kontejnerov/" target="_blank" rel="noopener" data-wpil-monitor-id="1240">установки Akeeba — настройка</a> расписания в:
# Components -> Akeeba Backup -> Backup Now (первый бэкап)
# Components -> Akeeba Backup -> Schedule Automatic Backups (расписание)

Включи кэширование

Идёшь в: System → Global Configuration → System. Включаешь «Cache» — тип «Conservative Caching» для начала. Это снизит нагрузку на сервер и ускорит отдачу страниц.

Обновляй расширения регулярно

В System → Update → Extensions ты видишь все расширения с доступными обновлениями. Проверяй раз в неделю. Устаревшие расширения — основная точка входа для взлома.

Скрой папку administrator

Стандартный адрес /administrator/ знают все боты. Можно переименовать папку с помощью расширения AdminExile или RSFirewall — это добавит лишний барьер для перебора паролей.

Включи двухфакторную аутентификацию

В Joomla 4 есть встроенная поддержка 2FA. Идёшь в профиль администратора: кликаешь по имени вверху справа → Edit Account → Multi-factor Authentication. Подключаешь Google Authenticator или Authy.

Мониторинг ошибок

Включи логирование в: System → Global Configuration → Logging. Лог-файлы хранятся в папке /logs/. Полезно смотреть периодически — особенно после обновлений.

# Следи за ошибками PHP через SSH в реальном времени:
tail -f /var/log/apache2/error.log
# или
tail -f /var/log/nginx/error.log

Прогноз: что теперь работает

Ты установил Joomla, подключил базу данных с правильной кодировкой, зашёл в административную панель, настроил шаблон оформления, создал первый материал и добавил его в меню. Расширения устанавливаются, плагины активируются, обновления применяются. Сайт работает.

Если что-то пошло не так — пиши в комментарии, разберёмся. Белый экран, ошибка базы, кривое меню — всё лечится, если знаешь где смотреть.