Feed of "bookstack/devops" https://codeberg.org/bookstack/devops Scripts and files to assist with installing and updating BookStack Wed, 04 Feb 2026 14:14:59 +0100 danb pushed to main at bookstack/devops /bookstack/devops/compare/7de45b7b354153472d09d8318d5d7a327df61e22...52212f4c38ef4fdbc17382a68b4a8eaf82ef6b65 <a href="https://codeberg.org/bookstack/devops/commit/52212f4c38ef4fdbc17382a68b4a8eaf82ef6b65">52212f4c38ef4fdbc17382a68b4a8eaf82ef6b65</a> Merge branch &#39;main&#39; of codeberg.org:bookstack/devops <a href="https://codeberg.org/bookstack/devops/commit/6883aa7674839d77ab1af20ce97ca419de24e28e">6883aa7674839d77ab1af20ce97ca419de24e28e</a> Updated release steps script 52212f4c38ef4fdbc17382a68b4a8eaf82ef6b65 Merge branch 'main' of codeberg.org:bookstack/devops 6883aa7674839d77ab1af20ce97ca419de24e28e Updated release steps script]]> danb 74643870: /bookstack/devops/compare/7de45b7b354153472d09d8318d5d7a327df61e22...52212f4c38ef4fdbc17382a68b4a8eaf82ef6b65 Sat, 22 Nov 2025 12:33:10 +0100 OscarLundberg closed issue bookstack/devops#46 https://codeberg.org/bookstack/devops/issues/46#issuecomment-8371902 docker-compose example does not work as-is OscarLundberg 74160720: https://codeberg.org/bookstack/devops/issues/46#issuecomment-8371902 Thu, 20 Nov 2025 12:27:14 +0100 OscarLundberg commented on issue bookstack/devops#46 https://codeberg.org/bookstack/devops/issues/46#issuecomment-8371899 docker-compose example does not work as-is <p dir="auto">Found this</p> Found this ]]> OscarLundberg 74160711: https://codeberg.org/bookstack/devops/issues/46#issuecomment-8371899 Thu, 20 Nov 2025 12:27:13 +0100 OscarLundberg commented on issue bookstack/devops#46 https://codeberg.org/bookstack/devops/issues/46#issuecomment-8353377 docker-compose example does not work as-is <p dir="auto">I could try it that way, although I did already try to delete only the bookstack container and volume dir, and then re-run <code>docker-compose up -d</code>. had the same error occur again.</p> I could try it that way, although I did already try to delete only the bookstack container and volume dir, and then re-run docker-compose up -d. had the same error occur again. ]]> OscarLundberg 73974669: https://codeberg.org/bookstack/devops/issues/46#issuecomment-8353377 Wed, 19 Nov 2025 17:03:54 +0100 danb commented on issue bookstack/devops#46 https://codeberg.org/bookstack/devops/issues/46#issuecomment-8352801 docker-compose example does not work as-is <p dir="auto">Hi <a href="/OscarLundberg" class="mention" rel="nofollow">@OscarLundberg</a>,</p> Hi @OscarLundberg, ]]> danb 73968222: https://codeberg.org/bookstack/devops/issues/46#issuecomment-8352801 Wed, 19 Nov 2025 16:36:59 +0100 OscarLundberg opened issue bookstack/devops#46 https://codeberg.org/bookstack/devops/issues/46 46#docker-compose example does not work as-is# i've been trying to get the docker-compose example running, but for whatever reason i can't get it to work.
https://codeberg.org/bookstack/devops/src/branch/main/config/lsio-docker/docker-compose.yml

I followed the link on https://www.bookstackapp.com/docs/admin/installation/ which led me here.

here are the steps i followed

  1. Create an empty directory and cd into it
  2. Create empty directories for the volumes mkdir bookstack_db_data and mkdir bookstack_app_data
  3. Create the file docker-compose.yml as linked above
  4. Paste in the file contents as linked above. Change only row 37 APP_KEY with the output from the command docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey
  5. Run docker-compose up -d

resulting error (logs from bookstack container)

  SQLSTATE[HY000] [2002] Operation timed out (Connection: mysql, SQL: select exists (select 1 from information_schema.tables where table_schema = 'bookstack' and table_name = 'migrations' and table_type in ('BASE TABLE', 'SYSTEM VERSIONED')) as `exists`)
  at /app/www/vendor/laravel/framework/src/Illuminate/Database/Connection.php:825
    821▕                     $this->getName(), $query, $this->prepareBindings($bindings), $e
    822▕                 );
    823▕             }
    824▕ 
  ➜ 825▕             throw new QueryException(
    826▕                 $this->getName(), $query, $this->prepareBindings($bindings), $e
    827▕             );
    828▕         }
    829▕     }
      +38 vendor frames 
  39  /app/www/artisan:35
      Illuminate\Foundation\Console\Kernel::handle()

No visible errors from mariadb.

Not sure if i'm missing anything but I would expect the example to work as-is.
using synology dsm fwiw

]]>
OscarLundberg 73936650: https://codeberg.org/bookstack/devops/issues/46 Wed, 19 Nov 2025 14:33:55 +0100
danb pushed to main at bookstack/devops https://codeberg.org/bookstack/devops/commit/7de45b7b354153472d09d8318d5d7a327df61e22 <a href="https://codeberg.org/bookstack/devops/commit/7de45b7b354153472d09d8318d5d7a327df61e22">7de45b7b354153472d09d8318d5d7a327df61e22</a> Added mention of mod_rewrite usage 7de45b7b354153472d09d8318d5d7a327df61e22 Added mention of mod_rewrite usage]]> danb 65158793: https://codeberg.org/bookstack/devops/commit/7de45b7b354153472d09d8318d5d7a327df61e22 Mon, 13 Oct 2025 13:52:34 +0200 danb pushed to main at bookstack/devops https://codeberg.org/bookstack/devops/commit/c1ec7865036e7b4858b06d6641a263fbc2a3abfd <a href="https://codeberg.org/bookstack/devops/commit/c1ec7865036e7b4858b06d6641a263fbc2a3abfd">c1ec7865036e7b4858b06d6641a263fbc2a3abfd</a> Added alpine 3.22 install script c1ec7865036e7b4858b06d6641a263fbc2a3abfd Added alpine 3.22 install script]]> danb 63644587: https://codeberg.org/bookstack/devops/commit/c1ec7865036e7b4858b06d6641a263fbc2a3abfd Tue, 07 Oct 2025 00:02:43 +0200 danb closed issue bookstack/devops#45 https://codeberg.org/bookstack/devops/issues/45#issuecomment-7404577 Ubuntu 24.04.3 Improvements danb 61560157: https://codeberg.org/bookstack/devops/issues/45#issuecomment-7404577 Sat, 27 Sep 2025 16:12:02 +0200 danb commented on issue bookstack/devops#45 https://codeberg.org/bookstack/devops/issues/45#issuecomment-7404574 Ubuntu 24.04.3 Improvements <p dir="auto">Okay, thanks for responding.</p> <p dir="auto">I&#39;ll therefore close this off since re-running the script worked okay, but I&#39;ll keep this in mind if I get further reports, or if there&#39;s specific errors to address.</p> Okay, thanks for responding.

I'll therefore close this off since re-running the script worked okay, but I'll keep this in mind if I get further reports, or if there's specific errors to address.

]]>
danb 61560151: https://codeberg.org/bookstack/devops/issues/45#issuecomment-7404574 Sat, 27 Sep 2025 16:12:01 +0200
sumdev commented on issue bookstack/devops#45 https://codeberg.org/bookstack/devops/issues/45#issuecomment-7394653 Ubuntu 24.04.3 Improvements <p dir="auto">Hi Dan,<br/> The failure occurred when installing on Ubuntu Server 24.04.3 VM. It failed starting the mysql service and the script stopped. It complained the mysql.service did not exist. I tried to recreate it to get you an install log, but for some reason in the new VM the script ran correctly, so I am not sure what the original issue was.</p> <p dir="auto">I also had issues with DOMAIN=$1 which also caused it to error out. I cannot remember what the error was though.</p> Hi Dan,
The failure occurred when installing on Ubuntu Server 24.04.3 VM. It failed starting the mysql service and the script stopped. It complained the mysql.service did not exist. I tried to recreate it to get you an install log, but for some reason in the new VM the script ran correctly, so I am not sure what the original issue was.

I also had issues with DOMAIN=$1 which also caused it to error out. I cannot remember what the error was though.

]]>
sumdev 61380013: https://codeberg.org/bookstack/devops/issues/45#issuecomment-7394653 Fri, 26 Sep 2025 18:46:19 +0200
danb pushed to main at bookstack/devops /bookstack/devops/compare/6d31b07e590708ba6b4931bb36c404627c0c2c91...f0fe5a06009fcf5591c668808e9107846bb543f4 <a href="https://codeberg.org/bookstack/devops/commit/f0fe5a06009fcf5591c668808e9107846bb543f4">f0fe5a06009fcf5591c668808e9107846bb543f4</a> Merge branch &#39;main&#39; of codeberg.org:bookstack/devops <a href="https://codeberg.org/bookstack/devops/commit/2584496ab8824235607d7b05e34772311c984221">2584496ab8824235607d7b05e34772311c984221</a> Added AlmaLinux 10 install script f0fe5a06009fcf5591c668808e9107846bb543f4 Merge branch 'main' of codeberg.org:bookstack/devops 2584496ab8824235607d7b05e34772311c984221 Added AlmaLinux 10 install script]]> danb 60528982: /bookstack/devops/compare/6d31b07e590708ba6b4931bb36c404627c0c2c91...f0fe5a06009fcf5591c668808e9107846bb543f4 Tue, 23 Sep 2025 00:20:26 +0200 danb commented on issue bookstack/devops#45 https://codeberg.org/bookstack/devops/issues/45#issuecomment-7307344 Ubuntu 24.04.3 Improvements <p dir="auto">Hi <a href="/sumdev" class="mention" rel="nofollow">@sumdev</a>,<br/> Can you describe the exact environment used to run the script where it failed (service used if any, if VM: host OS and VM software used, Exact Ubuntu download link used if any etc...).</p> <p dir="auto">Also, if you still have it, please share the install log from the original failed attempt (Should be in the same directory as where you originally ran the script from).</p> <p dir="auto">I don&#39;t think changes in Ubuntu should need those changes, but there could environmental elements which lead to differences, so it would be good to know those to properly plan for them in future.</p> Hi @sumdev,
Can you describe the exact environment used to run the script where it failed (service used if any, if VM: host OS and VM software used, Exact Ubuntu download link used if any etc...).

Also, if you still have it, please share the install log from the original failed attempt (Should be in the same directory as where you originally ran the script from).

I don't think changes in Ubuntu should need those changes, but there could environmental elements which lead to differences, so it would be good to know those to properly plan for them in future.

]]>
danb 60526762: https://codeberg.org/bookstack/devops/issues/45#issuecomment-7307344 Tue, 23 Sep 2025 00:06:21 +0200
sumdev opened issue bookstack/devops#45 https://codeberg.org/bookstack/devops/issues/45 45#Ubuntu 24.04.3 Improvements# I attempted to install Bookstack on a brand new Ubuntu Server 24.04.3 and the installation fails. I made some adjustments to the installation script to work with Ubuntu Server 24.04.3.

Changed these sections
#Get the domain from the arguments (Requested later if not set)
if [ -z "${1-}" ]; then
read -rp "Enter your domain (or press Enter to use IP $CURRENT_IP): " DOMAIN
DOMAIN=${DOMAIN:-$CURRENT_IP}
else
DOMAIN=$1
fi

#Install core system packages
function run_package_installs() {
apt update
apt install -y git unzip apache2 curl mysql-server php8.3
php8.3-fpm php8.3-curl php8.3-mbstring php8.3-ldap php8.3-xml php8.3-zip php8.3-gd php8.3-mysql
}

#Set up database
function run_database_setup() {
#Ensure database service has started
systemctl start mysql.service
systemctl enable mysql.service
sleep 3

]]>
sumdev 60460768: https://codeberg.org/bookstack/devops/issues/45 Mon, 22 Sep 2025 18:14:20 +0200
danb pushed to main at bookstack/devops https://codeberg.org/bookstack/devops/commit/6d31b07e590708ba6b4931bb36c404627c0c2c91 <a href="https://codeberg.org/bookstack/devops/commit/6d31b07e590708ba6b4931bb36c404627c0c2c91">6d31b07e590708ba6b4931bb36c404627c0c2c91</a> Update tinker-scripts/find-broken-internal-references.php 6d31b07e590708ba6b4931bb36c404627c0c2c91 Update tinker-scripts/find-broken-internal-references.php]]> danb 46626071: https://codeberg.org/bookstack/devops/commit/6d31b07e590708ba6b4931bb36c404627c0c2c91 Tue, 15 Jul 2025 13:50:14 +0200 danb pushed to main at bookstack/devops https://codeberg.org/bookstack/devops/commit/5efa798851aab4c8e1187d2981eb609aa97a9650 <a href="https://codeberg.org/bookstack/devops/commit/5efa798851aab4c8e1187d2981eb609aa97a9650">5efa798851aab4c8e1187d2981eb609aa97a9650</a> Added broken internal references tinker script 5efa798851aab4c8e1187d2981eb609aa97a9650 Added broken internal references tinker script]]> danb 46625102: https://codeberg.org/bookstack/devops/commit/5efa798851aab4c8e1187d2981eb609aa97a9650 Tue, 15 Jul 2025 13:43:26 +0200 danb deleted branch debian13_script from bookstack/devops https://codeberg.org/bookstack/devops danb 32863763: https://codeberg.org/bookstack/devops Wed, 07 May 2025 18:26:42 +0200 danb pushed to main at bookstack/devops /bookstack/devops/compare/4d3c44f576ac2ab34154e272c43061a35b02df9d...1a1083406ca2721df54c52530587819fb12a19b5 <a href="https://codeberg.org/bookstack/devops/commit/1a1083406ca2721df54c52530587819fb12a19b5">1a1083406ca2721df54c52530587819fb12a19b5</a> Debian 13 script: Fixed mysql use for mariadb, removed composer use <a href="https://codeberg.org/bookstack/devops/commit/e7ef268af2eb39a18cf15041d97bfb3c4579926a">e7ef268af2eb39a18cf15041d97bfb3c4579926a</a> Started a debian 13 script 1a1083406ca2721df54c52530587819fb12a19b5 Debian 13 script: Fixed mysql use for mariadb, removed composer use e7ef268af2eb39a18cf15041d97bfb3c4579926a Started a debian 13 script]]> danb 32863757: /bookstack/devops/compare/4d3c44f576ac2ab34154e272c43061a35b02df9d...1a1083406ca2721df54c52530587819fb12a19b5 Wed, 07 May 2025 18:26:41 +0200 danb merged pull request bookstack/devops#44 https://codeberg.org/bookstack/devops/pulls/44 Debian 13 install script danb 32863751: https://codeberg.org/bookstack/devops/pulls/44 Wed, 07 May 2025 18:26:41 +0200 danb pushed to debian13_script at bookstack/devops https://codeberg.org/bookstack/devops/commit/1a1083406ca2721df54c52530587819fb12a19b5 <a href="https://codeberg.org/bookstack/devops/commit/1a1083406ca2721df54c52530587819fb12a19b5">1a1083406ca2721df54c52530587819fb12a19b5</a> Debian 13 script: Fixed mysql use for mariadb, removed composer use 1a1083406ca2721df54c52530587819fb12a19b5 Debian 13 script: Fixed mysql use for mariadb, removed composer use]]> danb 32863712: https://codeberg.org/bookstack/devops/commit/1a1083406ca2721df54c52530587819fb12a19b5 Wed, 07 May 2025 18:26:06 +0200 danb created pull request bookstack/devops#44 https://codeberg.org/bookstack/devops/pulls/44 44#Debian 13 install script# A general copy across from our Ubuntu 24.04 script with some extra tweaks to play with some changes.
This is part of a move to allow other scripts, but with a non-supported/official status (to limit maintenance burden).

Todo

  • Fix mysql commands to suit mariadb (User create command)
  • Swap out composer install/usage to system cli download-vendor command
]]>
danb 32600213: https://codeberg.org/bookstack/devops/pulls/44 Tue, 06 May 2025 01:52:02 +0200
danb pushed to debian13_script at bookstack/devops https://codeberg.org/bookstack/devops/commit/e7ef268af2eb39a18cf15041d97bfb3c4579926a <a href="https://codeberg.org/bookstack/devops/commit/e7ef268af2eb39a18cf15041d97bfb3c4579926a">e7ef268af2eb39a18cf15041d97bfb3c4579926a</a> Started a debian 13 script e7ef268af2eb39a18cf15041d97bfb3c4579926a Started a debian 13 script]]> danb 32600066: https://codeberg.org/bookstack/devops/commit/e7ef268af2eb39a18cf15041d97bfb3c4579926a Tue, 06 May 2025 01:49:00 +0200 danb created branch debian13_script in bookstack/devops https://codeberg.org/bookstack/devops/src/branch/debian13_script danb 32600060: https://codeberg.org/bookstack/devops/src/branch/debian13_script Tue, 06 May 2025 01:49:00 +0200 danb pushed to main at bookstack/devops https://codeberg.org/bookstack/devops/commit/4d3c44f576ac2ab34154e272c43061a35b02df9d <a href="https://codeberg.org/bookstack/devops/commit/4d3c44f576ac2ab34154e272c43061a35b02df9d">4d3c44f576ac2ab34154e272c43061a35b02df9d</a> Updated release step order so checksums are created before commit 4d3c44f576ac2ab34154e272c43061a35b02df9d Updated release step order so checksums are created before commit]]> danb 25386647: https://codeberg.org/bookstack/devops/commit/4d3c44f576ac2ab34154e272c43061a35b02df9d Sun, 16 Mar 2025 14:49:41 +0100 danb pushed to main at bookstack/devops https://codeberg.org/bookstack/devops/commit/5004e252330296b4a8a09e45c982aec512de3fbd <a href="https://codeberg.org/bookstack/devops/commit/5004e252330296b4a8a09e45c982aec512de3fbd">5004e252330296b4a8a09e45c982aec512de3fbd</a> Adjusted version used for lsio container 5004e252330296b4a8a09e45c982aec512de3fbd Adjusted version used for lsio container]]> danb 25201678: https://codeberg.org/bookstack/devops/commit/5004e252330296b4a8a09e45c982aec512de3fbd Wed, 12 Mar 2025 13:58:32 +0100 danb pushed to main at bookstack/devops https://codeberg.org/bookstack/devops/commit/2282849c2fb3e74c6cfd49626b08bac66ce1e1d4 <a href="https://codeberg.org/bookstack/devops/commit/2282849c2fb3e74c6cfd49626b08bac66ce1e1d4">2282849c2fb3e74c6cfd49626b08bac66ce1e1d4</a> Tweaked store vendor script 2282849c2fb3e74c6cfd49626b08bac66ce1e1d4 Tweaked store vendor script]]> danb 25121741: https://codeberg.org/bookstack/devops/commit/2282849c2fb3e74c6cfd49626b08bac66ce1e1d4 Mon, 10 Mar 2025 22:25:27 +0100 danb pushed to main at bookstack/devops https://codeberg.org/bookstack/devops/commit/39010871bc991877ed987fe21e13f6a8213f915e <a href="https://codeberg.org/bookstack/devops/commit/39010871bc991877ed987fe21e13f6a8213f915e">39010871bc991877ed987fe21e13f6a8213f915e</a> Added script to create &amp; store ZIPped vendor directories 39010871bc991877ed987fe21e13f6a8213f915e Added script to create & store ZIPped vendor directories]]> danb 25110549: https://codeberg.org/bookstack/devops/commit/39010871bc991877ed987fe21e13f6a8213f915e Mon, 10 Mar 2025 16:44:51 +0100 danb pushed to main at bookstack/devops https://codeberg.org/bookstack/devops/commit/5a70cd76dbb33324a57b1907747c0c41b69059d9 <a href="https://codeberg.org/bookstack/devops/commit/5a70cd76dbb33324a57b1907747c0c41b69059d9">5a70cd76dbb33324a57b1907747c0c41b69059d9</a> Added lsio docker compose example, update license copyright 5a70cd76dbb33324a57b1907747c0c41b69059d9 Added lsio docker compose example, update license copyright]]> danb 23643850: https://codeberg.org/bookstack/devops/commit/5a70cd76dbb33324a57b1907747c0c41b69059d9 Sun, 16 Feb 2025 00:51:21 +0100 danb pushed to main at bookstack/devops https://codeberg.org/bookstack/devops/commit/487a7141c385375b2ae98723464cd2246b9b9901 <a href="https://codeberg.org/bookstack/devops/commit/487a7141c385375b2ae98723464cd2246b9b9901">487a7141c385375b2ae98723464cd2246b9b9901</a> Updated ubuntu scripts for PHP8.2 minimum 487a7141c385375b2ae98723464cd2246b9b9901 Updated ubuntu scripts for PHP8.2 minimum]]> danb 21782617: https://codeberg.org/bookstack/devops/commit/487a7141c385375b2ae98723464cd2246b9b9901 Wed, 08 Jan 2025 18:48:17 +0100 danb pushed to main at bookstack/devops /bookstack/devops/compare/0745c5d1ca696d492f8285137425d62c217524bb...4cb16efc1abf4b245746706cfcdbc8a2b3ed1301 <a href="https://codeberg.org/bookstack/devops/commit/4cb16efc1abf4b245746706cfcdbc8a2b3ed1301">4cb16efc1abf4b245746706cfcdbc8a2b3ed1301</a> Merge pull request &#39;Update config/nginx/subpath-proxy-config&#39; (#43) from Cirvaazny/devops:main into main <a href="https://codeberg.org/bookstack/devops/commit/fd02302ac5072dc4fcc4cf483859aaecef536323">fd02302ac5072dc4fcc4cf483859aaecef536323</a> Update config/nginx/subpath-proxy-config 4cb16efc1abf4b245746706cfcdbc8a2b3ed1301 Merge pull request 'Update config/nginx/subpath-proxy-config' (#43) from Cirvaazny/devops:main into main fd02302ac5072dc4fcc4cf483859aaecef536323 Update config/nginx/subpath-proxy-config]]> danb 19366960: /bookstack/devops/compare/0745c5d1ca696d492f8285137425d62c217524bb...4cb16efc1abf4b245746706cfcdbc8a2b3ed1301 Tue, 29 Oct 2024 11:46:40 +0100