Як встановити Wiki.js на AlmaLinux

Wiki.js – це сучасна і потужна вікі-платформа з відкритим вихідним кодом, побудована на Node.js. Вона пропонує зручний інтерфейс для створення, редагування та організації контенту, що робить її чудовим вибором для створення документації та спільної роботи. У цій статті представлено повну покрокову інструкцію зі встановлення Wiki.js на AlmaLinux 9, завдяки чому у вас буде все необхідне для початку роботи з власною вікі.

Необхідні умови

Перш ніж почати процес встановлення, переконайтеся, що у вас є такі необхідні умови:

Сервер AlmaLinux 9 із правами root або sudo.
Стабільне інтернет-з’єднання.
Базові знання про операції в командному рядку.
Програмні пакети: Docker, Node.js, PostgreSQL.

Крок 1: Оновлення системи

Підтримувати систему в актуальному стані дуже важливо для безпеки та стабільності. Почніть з оновлення індексу пакетів та оновлення встановлених пакетів:

sudo dnf update -y

Крок 2: Встановіть Docker

Docker – це платформа, що дає змогу розробникам автоматизувати розгортання додатків усередині легких контейнерів. Вона спрощує встановлення та управління такими додатками, як Wiki.js.

Щоб встановити Docker на AlmaLinux 9, виконайте такі команди:

sudo dnf install -y dnf-utils
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo dnf install -y docker-ce docker-ce-cli containerd.io
sudo systemctl start docker
sudo systemctl enable docker

Перевірте, чи правильно встановлено Docker, виконавши команду:

docker --version

Крок 3: Встановіть Node.js

Node.js необхідний для роботи Wiki.js, оскільки він забезпечує середовище виконання JavaScript. Для оптимальної продуктивності рекомендується остання версія LTS.

curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo dnf install -y nodejs

Перевірте встановлення, перевіривши версію Node.js:

node --version

Крок 4: Встановіть PostgreSQL

Для зберігання вмісту Wiki.js потрібна база даних. PostgreSQL – надійний і міцний вибір для цієї мети.

sudo dnf install -y postgresql-server postgresql-contrib
sudo postgresql-setup --initdb
sudo systemctl start postgresql
sudo systemctl enable postgresql

Створіть нову базу даних і користувача для Wiki.js:

sudo -u postgres psql
CREATE DATABASE wikijs;
CREATE USER wikiuser WITH ENCRYPTED PASSWORD 'your_password';
GRANT ALL PRIVILEGES ON DATABASE wikijs TO wikiuser;
\q

Крок 5: Завантаження та налаштування Wiki.js

Ви можете завантажити останню версію Wiki.js з GitHub:

wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz
mkdir -p /var/www/wikijs
tar -xzf wiki-js.tar.gz -C /var/www/wikijs --strip-components=1

Створіть файл конфігурації, скопіювавши файл прикладу:

cd /var/www/wikijs
cp config.sample.yml config.yml
nano config.yml

Крок 6: Створення служби Systemd для Wiki.js

Створіть файл служби для керування Wiki.js як фонової служби:

sudo nano /etc/systemd/system/wikijs.service

Додайте конфігурацію служби:

 [Unit]
Description=Wiki.js
After=network.target
[Service]
Type=simple
ExecStart=/usr/bin/node /var/www/wikijs/server
Restart=always
User=your_user_name
Environment=NODE_ENV=production
WorkingDirectory=/var/www/wikijs
[Install]
WantedBy=multi-user.target

Збережіть зміни та вийдіть

Увімкніть і запустіть службу

sudo systemctl daemon-reload
sudo systemctl enable wikijs
sudo systemctl start wikijs

Крок 7: Налаштуйте параметри брандмауера

Якщо у вас увімкнено брандмауер, дозвольте трафік HTTP і HTTPS:

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload

Крок 8: Доступ до майстра налаштування Wiki.js

Тепер ви можете отримати доступ до майстра налаштування Wiki.js через веб-браузер. Перейдіть на:

http://your-server-ip:3000

Усунення загальних проблем

Якщо у вас виникли проблеми із запуском служби, перевірте журнали, використовуючи:

journalctl -u wikijs

Якщо підключення до PostgreSQL не вдається, перевірте правильність облікових даних бази даних у файлі `config.yml`.
Якщо Docker не запускається, перевірте, чи запущено його за допомогою:

systemctl status docker

Якщо у вас виникнуть будь-які інші проблеми, зверніться по допомогу до офіційної документації Wiki.js або на форуми спільноти.

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