Run BookStack using Docker Compose & Nginx Proxy Manager

In this video I take you through the process of running BookStack using docker-compose and Nginx Proxy Manager from a fresh Ubuntu 20.04 server instance, complete with HTTPS via letsencrypt.
► Linuxserver.io container details: github.com/linuxserver/docker...
► Nginx Proxy Manager: nginxproxymanager.com/
► BookStack Commands Guide: www.bookstackapp.com/docs/adm...
► docker-compose.yml used: gist.github.com/ssddanbrown/7...
► BookStack Discord: / discord
► Follow BookStack on Mastodon: fosstodon.org/@bookstack
► Follow BookStack on Twitter: / bookstack_app
► Follow me on Mastodon: fosstodon.org/@danb
#opensource #selfhosted #documentation #wiki #bookstack #foss #docker #nginx #linuxserver.io

[@AsaelEstrella]

Good information, i am not an expert using docker, but whit this instruccions, i was able run BookStack. Thanks.

[@BookStackApp]

Good to hear this was helpful for you!

[@fcktom]

Spent the better part of my afternoon/evening struggling with my first deploy using docker-compose. Your video not only enabled me deploying it without any headache but I learned a lot about docker-compose. Appreciate you tremendously!!

[@BookStackApp]

Happy to hear this helped! You may also find my other video handy, for maintenance/admin actions when using the linuxserver container: kzbin.info/www/bejne/bHKbmX-rhrmegbM

[@Justincool69]

Great video with good information. I was able to get this up in running in no time. Thank you for the help!

[@JoelAldor]

Thank you Dan for these very clear instructions. I was able to run a demo environment for our company. Hopefully they get to adopt Bookstack as our KB portal. :)

[@Nights57]

Followed several different tutorials, this is the only one that got me up and running! Thanks!

[@BookStackApp]

Happy to hear it helped!

[@Sierra216]

There it is. I was trying to use https from nginx to bookstack and it was causing issues.

[@jeremyhawken4160]

Installation successfull thanks this tutorial :) ; Thanks !

[@narcisobatingaljr.6801]

Hello, is it possible to run the app locally? I followed the guide but it seems I lost. thank you.

[@vishnugoswamy]

Thank you for this tutorial .. I am getting below error while composing docker .. and line number 46 onwards is : - :volumes when I remove proxy section , it works well. so what is wrong in proxy section .. any idea

[@marciozotelli]

Nice tks

[@vishnugoswamy]

ok .. looks like I do not have /data/database.sqlite /etc/letsencrupt .. how to get it ?

[@DeveloperMarty]

I've been having issues getting the domain routing up. I was wondering why can't I just use my server's IP address in the docker config's environment/APP_URL parameter instead?

[@BookStackApp]

You totally can just user a server's IP address but things are a bit different in that scenario, and the networking will depend exactly where your host system is in relation to the devices you'd be using to access BookStack. This guide is primarily for hosting a web-accessible instance with https. For a local setup, you could just use the default linuxserver compose setup, without nginx proxy manager or https, and tweak it for your environment.

[@alihamdi9359]

Hello, thanks a lot for awesome tutorials, I want to ask if it is posible to connect(save) bookstack on SQL Server?

[@BookStackApp]

Hi! Unfortunately BookStack does not support SQL Server, Only MySQL (And compatible databases such as MariaDB).

[@alihamdi9359]

@@BookStackApp It's any other free wiki which supports SQL Server or can I use HeidiSQL instead of MySQL?

[@Pray4Tre]

i'm stuck with the ports. I have nginx setup and running prior to this, I also have a nextcloud container running on 80 and 443 and a mariadb on port 3306 already. Not sure all, some or neither of that matters as I'm relatively knew to docker. But when i run the docler-compose up, I get errors for 80,443,81 ports. I changed them to 85:80, 445:443,82:81 and ran a docker-compose up and it ran the logs but can't access the site. How should I handle these ports?

[@BookStackApp]

Ideally you need to use just one proxy system to handle all incoming connections to the machine on ports 80/443, so that one system can centrally manage where requests go and also manage https. If you already have nginx setup, you may look to use that instead of nginx proxy manager. Add a new config for your bookstack domain and proxy back to your running docker-compose stack. You'd need to expose port 80 within for the BookStack container to a port (6875 is commonly used) on host system so you can route nginx requests to it. If you're not confident with this networking side of things for now, might be better to have a separate machine to run this, as it can get complicated to mix docker and non-docker stuff on a machine, especially where they need to share ports/resources.

[@Pray4Tre]

@@BookStackApp Thanks for the help! I haven't been able to get it working yet but I do get a 502 bad gateway screen pop up when attempting to go to the site. Maybe i'm closer now.

[@mEti8]

How can I connect other CT to that nookstack_db?

[@BookStackApp]

You'd have to manually access the database to create any required users and databases. Then you'll need to figure out networking to ensure the DB container is visible by your other containers (Without being over-exposed). You could have them in the same docker-compose setup so it remains visible via the container name, as used by BookStack's DB_HOST configuration. Ideally you'd need knowledge in general networking and database administration.

[@fredzibulski3111]

i am using Bookstack on a reaspberry pi with docker and would like to know if there is a way to restore data ( books nd shelves that have been created ) if it has been deleted evidentially. all the files and images are in the folders but i do not know ow to get it back in bookstack to display

[@BookStackApp]

It really depends on how the containers were created, the container images in use, and how they've been altered since. KZbin isn't great from long-term debugging, but feel free to open a thread in our help-and-support discord channel (Discord link in video description)

[@fredzibulski3111]

@@BookStackApp thank you will raise the issue at discord

[@capsyatina]

I get error "permission denied" in started script, when I run docker-compose up. (((

[@BookStackApp]

Your user may not have permissions to run docker commands. This may be relevant for you: docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user

[@MieszkoNowak]

There is error "networks.default.external must be a boolean or mapping", docker change something. Don't make any network. And don't use network from 13:06 . Docker compose creates a network for those components itself. if you want to use own cert here is good guideline kzbin.info/www/bejne/pmmaoWSEn6qfndU

[@vishnugoswamy]

proxy: image: 'jc21/nginx-proxy-manager:latest' restart: unless-stopped ports: - '80:80' # Public HTTP Port - '443:443' # Public HTTPS Port - '81:81' # Admin Web Port environment: - ./proxy/data:/data - ./proxy/letsencrypt:/etc/letsencrypt