Установка MantisBT начинается не со скачивания архива, а с проверки окружения: без работающего веб-сервера, PHP и базы данных мастер установки просто не запустится и выдаст ошибку подключения. Именно на этапе подготовки окружения у большинства пользователей и возникают проблемы — установщик сообщает, что не может соединиться с базой, либо страница вообще не открывается.
В этой инструкции разберём, как установить Mantis Bug Tracker на локальный компьютер или сервер, какие компоненты нужны, как пройти веб-установщик и что проверить, если установка завершилась ошибкой. Шаги описаны в общем виде и подходят для большинства конфигураций, однако точные пути и команды зависят от вашей операционной системы и версии ПО — сверяйтесь с документацией к вашему стеку.
Что такое MantisBT и когда он нужен
MantisBT — это бесплатная система отслеживания ошибок (bug tracker) с открытым исходным кодом, написанная на PHP. Она используется командами разработки для учёта дефектов, задач и пожеланий пользователей: каждая проблема оформляется как «тикет» с приоритетом, статусом и ответственным исполнителем.
Система работает через браузер, поэтому для её развёртывания требуется классическая связка: веб-сервер, интерпретатор PHP и реляционная база данных. Установка возможна как на выделенный сервер под управлением Linux, так и на локальную машину с Windows — например, через готовые сборки вроде XAMPP, где Apache, PHP и MySQL уже собраны вместе.
Системные требования и подготовка окружения
Прежде чем скачивать дистрибутив, убедитесь, что окружение соответствует минимальным требованиям. Точные версии зависят от релиза MantisBT, поэтому актуальные требования всегда проверяйте в официальной документации к выбранной версии.
- 🖥️ Веб-сервер — Apache, Nginx или IIS с поддержкой выполнения PHP-скриптов.
- 🐘 PHP — версия, совместимая с вашим релизом MantisBT, с необходимыми расширениями для работы с базой данных.
- 🗄️ СУБД — MySQL или MariaDB (поддерживаются и другие базы, но эти — наиболее распространённый вариант).
- 📂 Права на файлы — веб-сервер должен иметь доступ на чтение каталога Mantis и на запись в служебные папки.
Для локальной установки на Windows проще всего использовать XAMPP или аналогичный пакет: после его установки веб-сервер и база данных запускаются из единой панели управления. На Linux-сервере компоненты ставятся через пакетный менеджер, например apt или dnf.
⚠️ Внимание: не ставьте MantisBT на хостинг или сервер, где версия PHP не поддерживается выбранным релизом системы. Несовместимость версий — одна из самых частых причин «белого экрана» и ошибок при установке. Проверяйте требования в официальной документации до начала работы.
Скачивание и распаковка дистрибутива
Дистрибутив MantisBT загружается с официального сайта проекта в виде архива. Скачивать установщик стоит только с официального источника — сторонние сборки могут содержать изменённый код.
После скачивания архив распаковывается в каталог, доступный веб-серверу. На локальной сборке XAMPP это обычно подкаталог внутри htdocs, на Linux-сервере — директория документов веб-сервера, например /var/www/html/. Итоговый адрес установки будет выглядеть примерно как http://localhost/mantisbt/ — в зависимости от того, как вы назвали папку.
# Пример для Linux: распаковка архива в каталог веб-сервера
sudo tar -xzf mantisbt-*.tar.gz -C /var/www/html/
sudo mv /var/www/html/mantisbt-* /var/www/html/mantisbt
На Linux также потребуется выставить владельца файлов, чтобы веб-сервер мог с ними работать. Обычно это пользователь, под которым запущен Apache или Nginx (например, www-data в Debian-подобных системах), но в вашей конфигурации имя может отличаться — проверьте настройки сервера.
Создание базы данных и пользователя
Следующий шаг — подготовить пустую базу данных, куда установщик запишет таблицы Mantis. Сделать это можно через phpMyAdmin (входит в состав XAMPP) или через консольный клиент MySQL. Вам нужно три вещи: имя базы, имя пользователя и его пароль.
CREATE DATABASE mantisbt CHARACTER SET utf8mb4;
CREATE USER 'mantisuser'@'localhost' IDENTIFIED BY 'надёжный_пароль';
GRANT ALL PRIVILEGES ON mantisbt.* TO 'mantisuser'@'localhost';
FLUSH PRIVILEGES;
Не используйте для подключения Mantis root-аккаунт базы данных — отдельный пользователь с правами только на одну базу безопаснее и упрощает администрирование. Запишите учётные данные: они понадобятся на следующем шаге в веб-установщике.
Запуск веб-установщика
Когда файлы размещены, а база создана, откройте в браузере адрес установки — например, http://localhost/mantisbt/. Если веб-сервер настроен правильно, Mantis автоматически перенаправит вас на страницу установщика admin/install.php.
В форме установки необходимо указать параметры подключения: тип базы данных, адрес сервера (для локальной установки — localhost), имя базы, имя пользователя и пароль, созданные на предыдущем шаге. После нажатия кнопки установки Mantis проверит соединение, создаст таблицы и запишет конфигурацию.
☑️ Проверка после установки MantisBT
⚠️ Внимание: после успешной установки обязательно удалите каталог admin из папки Mantis или ограничьте к нему доступ на уровне веб-сервера. Открытый установщик позволяет любому повторно инициализировать систему и перезаписать конфигурацию.
По завершении установки войдите под учётной записью администратора. В стандартной поставке предусмотрен встроенный аккаунт administrator с паролем по умолчанию — сразу после первого входа смените этот пароль в настройках учётной записи, иначе система останется открытой для посторонних.
Типичные ошибки при установке и их решение
Если установщик не запускается или завершается с ошибкой, причина обычно находится в одном из нескольких типовых мест. Ниже — таблица частых ситуаций и направления диагностики.
| Симптом | Возможная причина | Что проверить |
|---|---|---|
| Белая страница вместо установщика | Ошибка PHP или несовместимость версий | Логи веб-сервера и PHP, версию PHP |
| Ошибка подключения к базе данных | Неверный логин, пароль или хост | Учётные данные, запущен ли сервер БД |
| Ошибка прав доступа к файлам | Веб-сервер не может писать в каталог | Владельца и права на папки Mantis |
| Скачивается PHP-файл вместо страницы | PHP не подключён к веб-серверу | Модуль PHP в Apache/Nginx |
| Установщик не создаёт таблицы | У пользователя БД нет прав | Привилегии пользователя на базу |
Универсальный приём диагностики — чтение логов. Ошибки PHP и веб-сервера записываются в журналы, расположение которых зависит от вашей сборки: у XAMPP они находятся в каталоге logs, на Linux — обычно в /var/log/. Текст ошибки в логе почти всегда указывает на конкретную причину.
Как включить отображение ошибок PHP для диагностики
На время отладки можно включить вывод ошибок, задав в php.ini параметры display_errors = On и error_reporting = E_ALL, после чего перезапустить веб-сервер. На рабочем сервере вывод ошибок в браузер следует отключить и использовать только журналы — отображение служебной информации создаёт риск для безопасности.
Первоначальная настройка после установки
Установленная система готова к работе, но несколько действий стоит выполнить сразу. Войдите в раздел управления и последовательно проверьте основные разделы: учётные записи, проекты и глобальные настройки.
- 👤 Смените пароль администратора и отключите или защитите неиспользуемые встроенные учётные записи.
- 📁 Создайте первый проект — без него пользователям некуда добавлять задачи.
- ✉️ Настройте отправку почты, если нужны уведомления о новых задачах и изменениях статусов.
- 🌐 Проверьте язык интерфейса — русский язык доступен в настройках профиля пользователя.
Основные параметры системы хранятся в файле config_inc.php в корневом каталоге Mantis. Через него задаются настройки почты, безопасности и поведения интерфейса. Перед редактированием файла делайте резервную копию — синтаксическая ошибка в конфигурации может вывести систему из строя.
Часто задаваемые вопросы
Можно ли установить MantisBT на обычный виртуальный хостинг?
Да, если хостинг поддерживает PHP нужной версии и предоставляет базу данных MySQL или MariaDB. Файлы загружаются по FTP, база создаётся через панель управления хостингом, дальше установка идёт через веб-установщик по стандартному сценарию.
Что делать, если установщик пишет, что не может подключиться к базе данных?
Проверьте четыре параметра: адрес сервера базы, имя базы, логин и пароль. Убедитесь, что служба базы данных запущена, а пользователь имеет права именно на базу Mantis. Для локальной установки хост обычно localhost.
Нужно ли удалять папку admin после установки?
Да. Каталог admin содержит установщик и служебные скрипты. Пока он доступен из браузера, существует риск повторной инициализации системы посторонним. Удалите его или закройте доступ средствами веб-сервера.
Существует ли русский язык интерфейса в MantisBT?
Да, русская локализация входит в стандартную поставку. Язык выбирается в настройках профиля пользователя, а язык по умолчанию для всей системы можно задать в конфигурационном файле.
Можно ли поставить MantisBT в Docker?
Да, существуют образы для контейнерного развёртывания. Такой способ удобен тем, что окружение изолируется от основной системы, но требует базовых навыков работы с Docker и отдельной настройки подключения к базе данных.