Как установить BookStack на Ubuntu 24.04 Server

Разбираем установку BookStack на Ubuntu 24.04 Server вручную дабы понимать все шаги и уже с учетом этого если нужно будет сделать скрипт установки или какому как удобнее, мне проще сперва сделать от и до самим

Виртуальная машина под Proxmox 6.4-13

• VM: srv-us2404a
• CPU: 1 (4cores)
• HDD: 70Gb
• RAM: 4Gb

Много ранее я уже писал заметки, посвященные развертыванию BookStack посредством которого тестировал функционал создания Wiki, но тогда это была система Ubuntu 18.04 Server:

• Как установить BookStack на Ubuntu 18.04 Server
• Как прикрепить файл в BookStack
• Проработать бекап и восстановления для BookStack
• Настраиваем экспорт из BookStack в PDF

Шаг №1: Обновляем систему в рамках текущего LTS релиза до самого актуального состояния на момент составления текущей пошаговой заметки:

ekzorchik@srv-us2404a:~$ sudo nano /etc/update-manager/release-upgrades

[DEFAULT]

Prompt=never

ekzorchik@srv-us2404a:~$ sudo rm -rf /var/lib/apt/lists

ekzorchik@srv-us2404a:~$ sudo apt-get update && sudo apt-get upgrade -y && sudo apt-get dist-upgrade -y && sudo apt-get autoremove -y

после отправляю систему в перезагрузку

ekzorchik@srv-us2404a:~$ uname -a && lsb_release -a

Linux srv-us2204a 6.8.0-59-generic #61-Ubuntu SMP PREEMPT_DYNAMIC Fri Apr 11 23:16:11 UTC 2025 x86_64 x86_64 x86_64 GNU/Linux

No LSB modules are available.

Distributor ID: Ubuntu

Description:    Ubuntu 24.04.2 LTS

Release:        24.04

Codename:       noble

ekzorchik@srv-us2404a:~$

Шаг №2: Включаю текущую учетную запись под которой работаю в группу sudo дабы выполнять привилигированные команды не указывая пароль предваряя их sudo:

ekzorchik@srv-us2404a:~$ sudo visudo

ekzorchik ALL=(ALL) NOPASSWD:ALL

Шаг №3: Настройки синхронизации времени и настройки локали:

см заметку: "Настраиваем службу времени в Ubuntu 22.04 Server"

Шаг №4: Читаю документацию по части установки на официальном сайте и обнаруживаю, что для Ubuntu 24.04 есть скрипт:

A script to install BookStack on a fresh instance of Ubuntu 24.04 is available. This script is ONLY FOR A FRESH OS, it will install Apache, MySQL 8.0 & PHP 8.3 and could OVERWRITE any existing web setup on the machine. It also does not set up mail settings or configure system security so you will have to do those separately. You can use the script as a reference if you’re installing on a non-fresh machine.

Шаг №5: Произвожу установку через скрипт, который предлагает официальное руководство:

ekzorchik@srv-us2404a:~$ wget https://codeberg.org/bookstack/devops/raw/branch/main/scripts/installation-ubuntu-24.04.sh

ekzorchik@srv-us2404a:~$ chmod +x installation-ubuntu-24.04.sh

На заметку: в продуктиве не лишним будет открыть скрипт через редактор и изменить создаваемую базу, пользователя и пароль.

ekzorchik@srv-us2404a:~$ sudo ./installation-ubuntu-24.04.sh

This script installs a new BookStack instance on a fresh Ubuntu 24.04 server.

This script does not ensure system security.

This script logs full output to /home/ekzorchik/bookstack_install_1747219869.log which may help upon issues.

Enter the domain (or IP if not using a domain) you want to host BookStack on and press [ENTER].

Examples: my-site.com or docs.my-site.com or 172.33.33.127

172.33.33.127

Installing using the domain or IP "172.33.33.127"

[1/9] Installing required system packages... (This may take several minutes)

[2/9] Preparing MySQL database...

[3/9] Downloading BookStack to /var/www/bookstack...

[4/9] Installing Composer (PHP dependency manager)...

[5/9] Installing PHP dependencies using composer...

[6/9] Creating and populating BookStack .env file...

[7/9] Running initial BookStack database migrations...

[8/9] Setting BookStack file & folder permissions...

[9/9] Configuring apache server...

----------------------------------------------------------------

Setup finished, your BookStack instance should now be installed!

- Default login email: admin@admin.com

- Default login password: password

- Access URL: http://172.33.33.127/ or http://172.33.33.127/

- BookStack install path: /var/www/bookstack

- Install script log: /home/ekzorchik/bookstack_install_1747219869.log

---------------------------------------------------------------

ekzorchik@srv-us2404a:~$

Шаг №6: Обращаюсь из локальной сети к развернутому BookStack на URL адрес из результирующего вывода выше, т.е. URL: http://172.33.33.127

авторизуюсь, где данные для входа также беру из вывода выше

и нажимаю "Вход", я внутри после успешной авторизации

По сути Web-интерфейс такой же, как и в прошлый раз, когда делал, но тогда все делалось вручную на Ubuntu 18.04 Server, а тут скрипт сделал все за меня.

Шаг №7: Язык Web–интерфейса изменяется если в правой части нажать на Admin - My Account

Preferred Language: и изменить с "English" на "Русский"

и нажимаю "Save"

Шаг №8: Структура в BookStack и почему она удобная:

Всё построено по принципу “как в реальных книгах”. Есть Полки, Книги, Главы и Страницы.

Итого, в этой раз уже проще с развертыванием системы под базу знаний, но я не любитель на рабочем месте делиться своими наработками, не зачем кому-бы то нибыло выезжать за Ваш счет. К примеру я веду все свои заметки в обычных docx,odt,txt файлах по каталогам и все они синхронизируется с домашним хранилищем в OwnCloud, выглядит этот так:

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

На этом пока все, что хотел то посмотрел, с уважением автор блога Олло Александр aka ekzorchik.