Установка OrangeScrum на Ubuntu 18.04

Главный экран установки OrangeScrum

OrangeScrum — бесплатный open source инструмент управления проектами и совместной работы, написанный на PHP с использованием фреймворка CakePHP. Подходит для малых и средних команд: управление проектами, задачами, документами, коммуникация и интеграции (Dropbox, тикетинг, Gantt, Kanban и прочее). Эта инструкция подробно описывает установку и базовую настройку OrangeScrum на сервере Ubuntu 18.04 LTS.

Что вам нужно

Сервер с Ubuntu 18.04.
Непользователь root с правами sudo.
Домен или IP-адрес для доступа по HTTP.

Быстрая последовательность действий

Обновить систему.
Установить LAMP (Apache, MariaDB, PHP и модули).
Настроить php.ini (размеры загрузки, таймауты и т.п.).
Защитить MariaDB и создать базу/пользователя.
Отключить строгий режим SQL.
Скачать OrangeScrum, распаковать и импортировать database.sql.
Настроить app/Config/database.php и app/Config/config.ini.php.
Установить права на файлы и виртуальный хост Apache.
Перезапустить службы и пройти начальную регистрацию.

Подготовка системы

Сначала обновите систему до актуальных пакетов:

sudo apt-get update -y  
sudo apt-get upgrade -y

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

Установка LAMP и зависимостей

Установите Apache, MariaDB, PHP 7.2 и необходимые модули одной командой:

sudo apt-get install apache2 mariadb-server php7.2 php7.2-bcmath php7.2-cgi php7.2-cli php7.2-common php-curl php7.2-dba php7.2-enchant php7.2-fpm php7.2-gd php7.2-imap php7.2-intl php7.2-ldap php7.2-mbstring php7.2-mysql php7.2-opcache php-imagick php-memcache php7.2-soap php7.2-tidy php7.2-xml php7.2-zip libapache2-mod-php7.2 xvfb libfontconfig wkhtmltopdf unzip wget -y

Важно: версия PHP и набор модулей должны соответствовать требованиям OrangeScrum. Если у вас более новый дистрибутив с PHP 7.4/8.x, рассмотрите использование совместимой сборки или контейнеризации.

Отредактируйте php.ini для веб-сервера Apache:

sudo nano /etc/php/7.2/apache2/php.ini

В файле установите рекомендованные параметры:

post_max_size = 200M
upload_max_filesize = 200M
max_execution_time = 300
memory_limit = 512M
max_input_vars = 5000

Сохраните файл и закройте редактор. Затем стартуйте и включите службы Apache и MariaDB:

sudo systemctl start apache2  
sudo systemctl start mariadb  
sudo systemctl enable apache2  
sudo systemctl enable mariadb

Настройка базы данных MariaDB

Для безопасности выполните встроенную утилиту:

sudo mysql_secure_installation

Ответьте на вопросы, чтобы удалить анонимных пользователей, запретить удалённый вход root, удалить тестовую базу и перезагрузить таблицы привилегий.

Войдите в консоль MariaDB и создайте базу и пользователя для OrangeScrum:

mysql -u root -p

MariaDB [(none)]> CREATE DATABASE orangescrumdb;  
MariaDB [(none)]> GRANT ALL PRIVILEGES ON orangescrumdb.* TO 'orangescrumuser'@'localhost' IDENTIFIED BY 'password';
MariaDB [(none)]> FLUSH PRIVILEGES;  
MariaDB [(none)]> exit;

Замените ‘password’ на надёжный пароль.

Отключите строгий SQL-режим, создав конфигурационный файл:

sudo nano /etc/mysql/conf.d/disable_strict_mode.cnf

Добавьте:

[mysqld]
sql_mode="IGNORE_SPACE,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION"

Сохраните и перезапустите MariaDB:

sudo systemctl restart mariadb

Примечание: если вы используете MariaDB версии с другим набором sql_mode, убедитесь, что перечисленные режимы поддерживаются вашей версией.

Загрузка и установка OrangeScrum

Скачайте архив с официального сайта:

cd /tmp  
wget https://www.orangescrum.org/free-download/418ae4d8ef1309695804a7837cd4fc65/ubuntu18-php7 -O orangescrum-ubuntu18-php7.zip

Распакуйте и скопируйте в корень сайта Apache:

unzip orangescrum-ubuntu18-php7.zip
sudo cp -r orangescrum-orangescrum-ubuntu18-php7 /var/www/html/orangescrum-master

Импортируйте SQL-дамп в созданную базу:

cd /var/www/html/orangescrum-master  
sudo mysql -u orangescrumuser -p orangescrumdb < database.sql

Введите пароль пользователя базы, когда запросит mysql.

Отредактируйте файл с настройками базы данных приложения:

sudo nano app/Config/database.php

Пример требуемых настроек:

class DATABASE_CONFIG {

        public $default = array(
                'datasource' => 'Database/Mysql',
                'persistent' => false,
                'host' => 'localhost',
                'login' => 'orangescrumuser',
                'password' => 'password',
                'database' => 'orangescrumdb',
                'prefix' => '',
                'encoding' => 'utf8',
        );
}

Замените password на выбранный вами пароль.

Отредактируйте файл конфигурации email и пути для PDF:

sudo nano app/Config/config.ini.php

Пример блока:

[EMAIL INFO]
SMTP_UNAME = admin  
SMTP_PWORD = password
SMTP_HOST = smtp.example.com
SMTP_PORT = 25

[PDF PATH]
PDF_LIB_PATH = /usr/bin/wkhtmltopdf

Сохраните изменения.

Далее установите корректные права на файлы и каталоги:

sudo chown -R www-data:www-data /var/www/html/orangescrum-master/  
sudo chmod -R 775 /var/www/html/orangescrum-master/

Важно: права 775 дают группе www-data доступ на запись. Если в вашей среде соблюдаются строгие требования безопасности, настройте более ограничительные права и выделите конкретные каталоги для записи.

Конфигурация Apache

Создайте виртуальный хост для вашего домена:

sudo nano /etc/apache2/sites-available/orangescrum.conf

Добавьте:


        ServerAdmin [email protected]
        DocumentRoot /var/www/html/orangescrum-master/
        ServerName example.com
    
             DirectoryIndex index.php index.html
             AllowOverride All
             Allow from all
             Order allow,deny
             Options Indexes FollowSymlinks

Замените example.com на ваш домен или IP. Затем включите сайт и необходимые модули:

sudo a2ensite orangescrum.conf
sudo phpenmod mbstring  
sudo a2enmod rewrite  
sudo a2enmod headers
sudo systemctl restart apache2

Первый вход и проверка

Откройте браузер и перейдите на http://example.com (замените на свой адрес). Вы увидите страницу приветствия OrangeScrum.

Форма регистрации администратора OrangeScrum

Ошибка о правах на временную папку tmp можно игнорировать до завершения первоначальной регистрации — как правило она исчезает после правильной настройки владельца/права. Зарегистрируйте администратора, укажите имя сайта и почту. После регистрации вы попадёте в панель управления:

Панель управления OrangeScrum

Готовые образы виртуальной машины

Урок доступен в виде готового OVF/OVA-образа (совместим с VMware и VirtualBox). Предоставленные логины по умолчанию в образе:

SSH / Shell Login

Username: administrator
Password: howtoforge

Этот пользователь имеет права sudo.

Orangescrum Login

Username: [email protected]
Password: howtoforge

MySQL Login

Username: root
Password: howtoforge

Username: orangescrumuser
Password: password

IP виртуальной машины по умолчанию 192.168.1.100 — изменяется в /etc/netplan/01-netcfg.yaml. Немедленно смените все пароли после развёртывания образа.

Диагностика и типичные проблемы

Проблема: “500 Internal Server Error” после установки.
Действия: проверьте логи Apache (/var/log/apache2/error.log), права на файлы, модуль rewrite и AllowOverride в конфигурации виртуального хоста.
Проблема: Ошибки при импорте database.sql.
Действия: убедитесь, что дамп не повреждён, пользователь БД имеет права на базу и кодировка совпадает (utf8).
Проблема: wkhtmltopdf не создаёт PDF.
Действия: проверьте наличие бинарника в /usr/bin/wkhtmltopdf и права на исполнение. Для headless-серверов может потребоваться xvfb.
Проблема: не приходят письма SMTP.
Действия: проверьте параметры SMTP в app/Config/config.ini.php, убедитесь, что сервер SMTP доступен с сервера и параметры (порт, шифрование) корректны.
Проблема: “max_input_vars” или лимиты памяти.
Действия: увеличьте соответствующие значения в php.ini и перезапустите Apache.

Альтернативные подходы

Контейнеризация: запускайте OrangeScrum в Docker с отдельными контейнерами для PHP-FPM, Nginx/Apache и MariaDB — упрощает управление зависимостями и миграцию версий PHP.
Предустановленные образы: использовать готовые OVA/OVF для быстрого развёртывания тестовой среды.
Менеджер пакетов/репозиторий: при наличии официального репозитория можно управлять обновлениями через APT.

Модель принятия решений перед установкой

Если нужен быстрый тестовый стенд — используйте образ OVA/OVF.
Для боевого развёртывания с контролем зависимостей и масштабированием — используйте контейнеры и отдельный хост для БД.
Если инфраструктура требует более новой версии PHP, планируйте тестовую миграцию и проверку совместимости плагинов и модулей.

Критерии приёмки

Сайт отвечает по HTTP/HTTPS и отображает страницу приветствия OrangeScrum.
Можно зарегистрировать администратора и войти в панель.
Импорт данных выполнен без ошибок, и страницы проектов доступны.
Отправка почты с текущих настроек SMTP тестируется успешно.
Создание PDF для отчетов работает (wkhtmltopdf).

Playbook отката (короткий)

Если обновление/настройка привела к неработоспособности, остановите веб-сервер.
Восстановите резервную копию базы данных и каталога /var/www/html/orangescrum-master.
Откатьте изменения конфигурации Apache и php.ini.
Запустите проверки и верните трафик.

Чек-листы по ролям

Администратор системы

Обновить систему и пакеты.
Настроить бэкапы и мониторинг доступности.
Настроить HTTPS и брандмауэр.

Разработчик/Интегратор

Проверить совместимость плагинов и настроек PHP.
Протестировать отправку почты и генерацию PDF.
Настроить интеграции (Dropbox, тикетинг).

Оператор поддержки

Проверять логи и устранять ошибки прав доступа.
Помогать пользователям с регистрацией и доступом.

Тесты и критерии приёмки

Пройти сценарий: регистрация администратора → создание проекта → создание задачи → загрузка файла → отправка уведомления по почте.
Проверить создание PDF-отчёта и его корректность.
Проверить скорость загрузки главной страницы и время ответа API (если используется).

Краткая методология развёртывания

Подготовка: обновления, бэкапы, выделенный тестовый сервер.
Установка зависимостей.
Конфигурация БД и приложения.
Проверка в тестовой среде.
Перенос в продуктив и мониторинг.

Советы по миграции и обновлению

Перед обновлением OrangeScrum сделайте полную резервную копию базы и файлов.
Тестируйте обновления на отдельном стенде с такой же версией PHP/MariaDB.
При переходе на более новую версию PHP проверьте поддержку всех используемых расширений.

Шпаргалка команд

Обновление пакетов: sudo apt-get update && sudo apt-get upgrade -y
Старт/стоп сервисов: sudo systemctl start|stop|restart apache2 mariadb
Включение сайта: sudo a2ensite orangescrum.conf
Управление модулями PHP/Apache: sudo phpenmod mbstring; sudo a2enmod rewrite

Заключение

OrangeScrum можно быстро развёртывать на Ubuntu 18.04 при соблюдении требований к PHP и правам файлов. Для боевого использования рекомендуется SSL, жёсткая политика паролей, регулярные бэкапы и мониторинг. Если нужны масштабируемость и изоляция зависимостей — рассматривайте контейнеризацию.

Важно: сразу смените дефолтные пароли в образе, ограничьте публичный доступ к административным URL и организуйте регулярные бэкапы.

Ссылки

https://www.orangescrum.org/