Hi everyone, I´ve been using TrueNAS Scale as my trusted Homelab Server for 1,5 years now, and I´ve so far only been relying on official apps by TrueNAS (using the occasional Truecharts app a few months back and uninstalling them rather swiftly).
I´ve recently upgraded my system to ElectricEel-24.10.2 and wanted to get a knowledge-management tool to work similar to Confluence. From what I´ve seen so far, Bookstack meets my requirements for the most part.
I´ve never installed a custom app before and also have rather limited knowledge of Linux systems, so I´ve had some issues. I tried to get Bookstack to run for the past few days and now I really don´t know what I´m missing here. Maybe someone can help me out (and explain it to me like I´m 5 ).
Afaik, I need MariaDB first for Bookstack, so I installed it from the official app list. But I´m not sure it´s configured properly.
But MariaDB is at least up and running.
So now I created the Custom App for Bookstack.
Now for my questions:
Is MariaDB configured correctly?
Is Bookstack configured correctly?
One problem I had was with the Bookstack environment variable APP_KEY. In the Bookstack guide, it says that the session encryption key needs to be generated with docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey . Do I run this in the Bookstack container shell? When I tried this, I get docker: not found.
The Bookstack App however is starting up, but I cannot access the WebGUI. Neither without reverse proxy (accessing via TrueNAS IP:Port15000) nor with reverse proxy Nginx (just showing 502 error - bad gateway).
Please help me get this running, would be most appreciated!
The way to use really any custom app is via a compose file, and the best way to handle those is through either Portainer or Dockge. But with that said, you should be able to use the built-in facility to install it too. You do not need any separate apps. Based on the instructions here:
…and the compose file here:
At your TrueNAS shell, run sudo docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey. It will produce output like base64:BjPmlmNurOj/bRbPv/5LszyY6ctdrsy4mr0LD79HiMI=. Save this somewhere.
Then go to Apps, Discover, click the kebab menu, and select Install via YAML. Paste in the compose file I linked above, and make the following changes:
Change APP_KEY to match the value you generated above
Change APP_URL to http://truenas_ip:6875 (where, of course, truenas_ip is the IP address of your TrueNAS server)
Change the volumes for both bookstack and mariadb to match actual paths on your NAS where you want to store the data in question. An example might be - /mnt/tank/bookstack/bookstack_app_data:/config.
Click Save at the bottom and give it a moment to deploy. Then browse to http://truenas_ip:6875 and log in with the default credentials.
).
