Як встановити Kanboard на Ubuntu

Kanboard – це потужний інструмент управління проектами з відкритим вихідним кодом, який використовує методологію Kanban, щоб допомогти командам візуалізувати робочі процеси та ефективно керувати завданнями. Цей посібник проведе вас через покроковий процес інсталяції Kanboard на Ubuntu 24.04 LTS, забезпечуючи вас надійною платформою для управління проектами. Якщо ви розробник, менеджер проєкту або керівник команди, встановлення Kanboard значно розширить ваші можливості з управління проєктами.

Що таке Kanboard?

Kanboard – це просте, але ефективне програмне забезпечення для управління проєктами, призначене для організації завдань і управління робочими процесами. Основна увага в ньому приділяється візуалізації роботи за допомогою Kanban-дощок, що дає змогу командам відстежувати перебіг роботи та безперешкодно співпрацювати. Деякі ключові особливості Kanboard включають:

• Призначення завдань із зазначенням термінів виконання
• Настроювані робочі процеси
• Вкладення файлів і підзадачі
• Інтеграція із зовнішніми сервісами за допомогою плагінів

Порівняно з іншими інструментами управління проєктами, як-от Trello, Kanboard пропонує більш мінімалістичний інтерфейс, що робить його ідеальним для невеликих команд і проєктів, які потребують простого управління завданнями.

Системні вимоги

• Перш ніж приступити до встановлення, переконайтеся, що ваша система відповідає таким вимогам:
• Операційна система: Ubuntu 24.04 LTS
• Веб-сервер: Apache або Nginx
• База даних: MariaDB або MySQL
• PHP: Версія 7.4 або вище з необхідними розширеннями (php-mysql, php-gd, php-mbstring, php-xml)

Крок 1: Оновлення та модернізація пакетів

Перший крок у процесі встановлення – переконатися, що пакети вашої системи оновлені. Відкрийте термінал і виконайте такі команди:

sudo apt update && sudo apt upgrade -y

Ця команда оновлює список пакетів і оновлює всі застарілі пакети у вашій системі.

Крок 2: Встановлення необхідного програмного забезпечення

Вам буде потрібно встановити Apache (або Nginx), MariaDB (або MySQL) і PHP, а також кілька розширень PHP. Для встановлення цих компонентів використовуйте таку команду:

sudo apt install apache2 mariadb-server php php-mysql php-gd php-mbstring php-xml -y

Ця команда встановлює веб-сервер Apache, сервер баз даних MariaDB і PHP разом із необхідними розширеннями, необхідними Kanboard.

Крок 3: Налаштування MariaDB

Після встановлення MariaDB необхідно забезпечити безпеку встановлення. Виконайте таку команду:

sudo mysql_secure_installation

Цей скрипт запропонує вам встановити пароль root і видалити анонімних користувачів, а також вжити інших заходів безпеки. Уважно дотримуйтесь підказок, щоб підвищити безпеку бази даних.

Крок 4: Створення бази даних і користувача для Kanboard

Увійдіть у консоль MariaDB, використовуючи:

sudo mysql -u root -p

Створіть нову базу даних для Kanboard і користувача з відповідними привілеями, виконавши ці SQL-команди:

CREATE DATABASE kanboard;
CREATE USER 'kanboarduser'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON kanboard.* TO 'kanboarduser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Замініть ‘your_password’ на надійний пароль, який ви запам’ятаєте.

Крок 5: Завантажити Kanboard

Наступним кроком буде завантаження останньої версії Kanboard з його репозиторію на GitHub. Використовуйте таку команду:

wget https://github.com/kanboard/kanboard/archive/v1.2.24.tar.gz

Крок 6: Витяг і переміщення файлів

Після завантаження витягніть файли за допомогою:

tar -xvzf v1.2.24.tar.gz

Потім перемістіть витягнутий каталог у кореневий каталог вашого веб-сервера:

sudo mv kanboard-1.2.24 /var/www/html/kanboard

Крок 7: Створення файлу конфігурації віртуального хоста

Створіть новий файл конфігурації віртуального хоста для Kanboard за допомогою зручного текстового редактора:

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

Додайте в цей файл такі параметри конфігурації

<VirtualHost *:80>
    ServerAdmin [email protected]
    DocumentRoot /var/www/html/kanboard
    ServerName example.com

    ErrorLog ${APACHE_LOG_DIR}/kanboard-error.log
    CustomLog ${APACHE_LOG_DIR}/kanboard-access.log combined

    <Directory "/var/www/html/kanboard">
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Переконайтеся, що ви замінили ‘example.com’ на ваше реальне доменне ім’я.

Крок 8: Увімкніть сайт і перезапустіть Apache

Увімкніть нову конфігурацію віртуального хоста і перезапустіть Apache, щоб зміни набули чинності:

sudo a2ensite kanboard.conf
sudo systemctl restart apache2

Крок 9: Встановлення дозволів для каталогу Kanboard

Вам потрібно встановити правильні дозволи для каталогу Kanboard, щоб він міг правильно записувати дані:

sudo chown -R www-data:www-data /var/www/html/kanboard/data
sudo chmod -R 755 /var/www/html/kanboard

Крок 10: Доступ до веб-інтерфейсу Kanboard

Тепер ви можете отримати доступ до Kanboard, перейшовши за адресою http://example.com. Ви побачите сторінку входу в систему Kanboard.

За замовчуванням використовуються такі облікові дані для входу:

• Email: [email protected]
• Пароль: admin

З метою безпеки змініть ці дані відразу після входу в систему.

Усунення поширених проблем

• Помилка: «403 Forbidden»: Зазвичай це вказує на проблеми з правами доступу. Переконайтеся, що веб-сервер має права доступу до каталогів.
• Помилка: «Підключення до бази даних не вдалося»: Перевірте, чи правильно ви створили базу даних і чи ввели ви правильні облікові дані у файлі /var/www/html/kanboard/config.php.
• Помилка: «404 Not Found»: Переконайтеся, що конфігурація віртуального хоста правильна і що ви включили його в Apache.
• Помилка: «500 Internal Server Error»: Перевірте журнали помилок Apache, розташовані за адресою /var/log/apache2/kanboard-error.log. Це може допомогти зрозуміти, що саме пішло не так.
• Помилка: «PHP Extensions Missing»: Переконайтеся, що всі необхідні розширення PHP встановлені, як зазначено в попередніх кроках.
• Помилка: «SSL-сертифікат не знайдено»: Якщо використовується HTTPS, переконайтеся, що SSL налаштовано правильно за допомогою Certbot або іншої служби SSL.
• Помилка: «Помилка тайм-ауту»: Це може бути спричинено перевантаженням сервера або неправильною конфігурацією; перевірте навантаження на сервер і відповідну конфігурацію.
• Помилка: «Перевищено ліміт пам’яті»: Збільште ліміт пам’яті в конфігураційному файлі PHP (/etc/php/7.x/apache2/php.ini ), змінивши значення ;memory_limit = 128M .
• Помилка: «Помилка зберігання сеансу»: Переконайтеся, що права доступу встановлено правильно для каталогів зберігання сеансів у каталозі програми.
• Помилка: «Plugin Not Found»: Переконайтеся, що плагіни правильно встановлені у відповідні каталоги і сумісні з вашою версією Kanboard.
• Помилка: «Завантаження файлів вимкнено»: Перевірте налаштування у файлі /etc/php/7.x/apache2/php.ini, зокрема переконайтеся, що ;file_uploads = On.
• Помилка: «Data Directory Not Writable»: Переконайтеся, що права доступу до каталогу даних (/var/www/html/kanboard/data ) встановлено правильно, як показано вище.
• Помилка: «Debugging Mode On»: Якщо ви бачите налагоджувальні повідомлення на екрані, вимкніть режим налагодження в конфігураційному файлі (/var/www/html/kanboard/config.php), встановивши ‘DEBUG’ => false .
• Помилка: «Недійсний токен» під час спроби входу в систему: Очистіть кеш браузера або спробуйте увійти в систему з вікна інкогніто, якщо ця проблема зберігається.

Вітаємо! Ви успішно встановили Kanboard. Для отримання додаткової допомоги або корисної інформації ми рекомендуємо вам відвідати офіційний сайт Kanboard.