Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

[Support] Linuxserver.io - Bookstack

Featured Replies

On 1/20/2022 at 10:27 AM, lyricmuse said:

Having the same issue as @Built2Succeed

It was working fine until an update and now it doesn't connect to the dbase anymore and renders the page as seen in the screenshots from built2succeed.  I setup a domain name before hand and set the url https as the instructions stated.  Setup a dbase with MariaDB and tested working about a week ago.  Still muddling through how to fix it, but I think I'm going to delete the app and redo everything.  Not sure how to save what I have already put into Bookstack though.

mine is working now. Did you get it working?

  • 5 months later...
  • Replies 116
  • Views 69.6k
  • Created
  • Last Reply

Top Posters In This Topic

Most Popular Posts

  • You have specified the port in the host variable. Remove the port and it should work.

  • This was it. Thanks a lot for the info. The update is great.

  • secondsunrise
    secondsunrise

    EDIT: I got it working - thank you @j0nnymoe! Here are the steps in case anyone else needs to get this setup:   1. Click on the bookstack docker icon and select console. 2. Type in nano

Posted Images

Anyone have issues with the latest update?  The login page no longer appears for me.  I just get an error message saying this site can't be reached.  If I re-deploy v22.06.2-ls25 everything is fine.  Any ideas what I might be missing?  Thanks.

On 7/23/2022 at 1:46 PM, Mogo said:

Anyone have issues with the latest update?  The login page no longer appears for me.  I just get an error message saying this site can't be reached.  If I re-deploy v22.06.2-ls25 everything is fine.  Any ideas what I might be missing?  Thanks.

Blast you aren't alone there - I blindly applied the update some time ago and just noticed it was broken - I don't rely on Bookstack every day but confirmed that ls25 did patch it up (thanks for that!)

On 7/23/2022 at 8:46 PM, Mogo said:

Anyone have issues with the latest update?  The login page no longer appears for me.  I just get an error message saying this site can't be reached.  If I re-deploy v22.06.2-ls25 everything is fine.  Any ideas what I might be missing?  Thanks.

I had an issue like this recently. I just needed to set the "APP_URL" container variable. See if your log says anything about an IP address, that's what tipped me off.

6 hours ago, xaositek said:

Blast you aren't alone there - I blindly applied the update some time ago and just noticed it was broken - I don't rely on Bookstack every day but confirmed that ls25 did patch it up (thanks for that!)

 

No Problem.

 

5 hours ago, Ademar said:

I had an issue like this recently. I just needed to set the "APP_URL" container variable. See if your log says anything about an IP address, that's what tipped me off.

 

What did you set yours at?  For example I am currently on the working version for me (v22.06.2-ls25) and the only thing I see related to your comment in the logs is this:
Docker env var APP_URL is not set, setting it to http://10.100.0.1:3000.  This url does not work.  If I go to the proper url for unraid like 172.16.1.1:3000 then that works.  Assuming that 172.16.1.1 is my unraid url, I assume you mean to add the 172.16.1.1:3000 value to the field below?

 

The URL for bookstack if using reverse proxy. your.site.here.xyz:

18 hours ago, Mogo said:

Assuming that 172.16.1.1 is my unraid url, I assume you mean to add the 172.16.1.1:3000 value to the field below?

 

The URL for bookstack if using reverse proxy. your.site.here.xyz:

Correct. (I use a local domain name, set in Pi-hole. So i set something like http://some.name)

2 hours ago, Ademar said:

Correct. (I use a local domain name, set in Pi-hole. So i set something like http://some.name)

Okay that was it for me - my local DNS name is "wiki" so my APP_URL to be https://wiki (I use bridged mode so port 443 for my install) and now the most recent version is working great!

Thanks everyone, that works for me as well with the latest update.

  • 2 months later...

Is anyone having issues with the latest update? My pages aren't rendering properly, and are taking a very long time.

  • 2 months later...

My bookstack is destroyed since latest update. Everything is scaled wrong. Huge black icons. 
 

Anyone that has the same problem?

  • 2 weeks later...
On 12/23/2022 at 2:40 PM, Cyborg said:

My bookstack is destroyed since latest update. Everything is scaled wrong. Huge black icons. 
 

Anyone that has the same problem?

 

Add a new env var called APP_URL and then the value of your ip/port like http://192.168.99.110:82 for example. Somebody suggested it in earlier comments and that fixed it for me. Good luck.

On 12/31/2022 at 11:00 PM, BayRaid said:

 

Add a new env var called APP_URL and then the value of your ip/port like http://192.168.99.110:82 for example. Somebody suggested it in earlier comments and that fixed it for me. Good luck.

thank you, it was the ip that was wrong. 

  • 3 months later...

Sometimes when I take a screenshot of a whole page and try and paste it into bookstack, I get this error:
"An error occurred uploading the image"  If I did a screenshot of a quarter of the page and pasted that then it is successful.

 

Is there a setting or option I need to change?  I already have FILE_UPLOAD_SIZE_LIMIT=1000 which doesn't seem to help.

  • 6 months later...

Will Bookstack work with a static IP instead of using bridge mode?  If so, what is the best way to do this as I have it connecting to Maria database docker which is using a static IP.

 

Thanks

  • 1 month later...
On 1/14/2022 at 6:13 PM, Built2Succeed said:

Running on UnRAID. Bookstack is installed in a container, and NGINX Proxy Manager is installed in a separate container on the same custom network. as well as MariaDB. when I open the webui it looks like this. also note the weird url it takes me to.  I put in 192.168.1.238:6875 and this is exactly what it does.  I hope someone can help.  I was thinking this was going to be a simple install and it has been a nightmare, with countless hours spent attempting to fix.

 

 

1703555505_Screenshot(36).thumb.png.ce5b02832b6078a1e801c963727cb8f8.png501190995_Screenshot(35).thumb.png.669825d704b688e6f434e86b26b09ad0.png

 

This is the command that it runs to start the docker:
docker run -d --name=‘bookstack’ --net=‘proxynet’ -e TZ=“America/New_York” -e HOST_OS=“Unraid” -e ‘DB_HOST’=‘192.168.1.238:3306’ -e ‘DB_USER’=‘bookstack’ -e ‘DB_PASS’=‘password’ -e ‘DB_DATABASE’=‘bookstack’ -e ‘APP_URL’=‘192.168.1.238:6875’ -e ‘PUID’=‘99’ -e ‘PGID’=‘100’ -e ‘UMASK’=‘022’ -p ‘6875:80/tcp’ -v ‘/mnt/user/appdata/bookstack’:’/config’:‘rw’ ‘linuxserver/bookstack:v21.11.1-ls172’

 

When i put in username: [email protected] password: password it gives me this error:

 

Oops! An Error Occurred

The server returned a “405 Method Not Allowed”.

Something is broken. Please let us know what you were doing when this error occurred. We will fix it as soon as possible. Sorry for any inconvenience caused.

 

Bookstack logfile:

[s6-init] making user provided files available at /var/run/s6/etc…exited 0.
[s6-init] ensuring user provided files have correct perms…exited 0.
[fix-attrs.d] applying ownership & permissions fixes…
[fix-attrs.d] done.
[cont-init.d] executing container initialization scripts…
[cont-init.d] 01-envfile: executing…
[cont-init.d] 01-envfile: exited 0.
[cont-init.d] 10-adduser: executing…

_ ()
| | ___ _ __
| | / | | | /
| | _ \ | | | () |
|| |/ || __/

Brought to you by linuxserver.io

To support LSIO projects visit:
Donate | LinuxServer.io

GID/UID

User uid: 99
User gid: 100

[cont-init.d] 10-adduser: exited 0.
[cont-init.d] 20-config: executing…
[cont-init.d] 20-config: exited 0.
[cont-init.d] 30-keygen: executing…
using keys found in /config/keys
[cont-init.d] 30-keygen: exited 0.
[cont-init.d] 50-config: executing…
New container detected. Setting up app folder and fixing permissions.
App Key found - setting variable for seds
Running config - db_user set
**** APP_URL in /config/www/.env is being updated from 172.18.0.1 to 192.168.1.238 ****
**** If this is an existing install, you should run the following line from your host terminal to update the database URL entries: ****

docker exec -it bookstack php /var/www/html/artisan bookstack:update-url 172.18.0.1 192.168.1.238

nc: getaddrinfo: Name does not resolve
nc: getaddrinfo: Name does not resolve
nc: getaddrinfo: Name does not resolve
nc: getaddrinfo: Name does not resolve
nc: getaddrinfo: Name does not resolve
nc: getaddrinfo: Name does not resolve
Nothing to migrate.
[cont-init.d] 50-config: exited 0.
[cont-init.d] 90-custom-folders: executing…
[cont-init.d] 90-custom-folders: exited 0.
[cont-init.d] 99-custom-files: executing…
[custom-init] no custom files found exiting…
[cont-init.d] 99-custom-files: exited 0.
[cont-init.d] done.
[services.d] starting services
[services.d] done.

Having same issues as above.

 

Here is my docker log:

 

[migrations] started
[migrations] 01-nginx-site-confs-default: skipped
[migrations] 02-default-location: skipped
[migrations] done
───────────────────────────────────────

      ██╗     ███████╗██╗ ██████╗ 
      ██║     ██╔════╝██║██╔═══██╗
      ██║     ███████╗██║██║   ██║
      ██║     ╚════██║██║██║   ██║
      ███████╗███████║██║╚██████╔╝
      ╚══════╝╚══════╝╚═╝ ╚═════╝ 

   Brought to you by linuxserver.io
───────────────────────────────────────

To support LSIO projects visit:
https://www.linuxserver.io/donate/

───────────────────────────────────────
GID/UID
───────────────────────────────────────

User UID:    99
User GID:    100
───────────────────────────────────────

using keys found in /config/keys
App Key found - setting variable for seds
Running config - DB_HOST set
**** APP_URL in /config/www/.env is being updated from 192.168.21.21 to http<s>://192.168.21.21:6875 ****
**** If this is an existing install, you should run the following line from your host terminal to update the database URL entries: ****
************************************************************************
docker exec -it bookstack php /app/www/artisan bookstack:update-url 192.168.21.21 http<s>://192.168.21.21:6875
************************************************************************
Waiting for DB to be available

   INFO  Nothing to migrate.  

[custom-init] No custom files found, skipping...
[ls.io-init] done.

 

Docker template:

docker run
  -d
  --name='bookstack'
  --net='wiki'
  -e TZ="Europe/London"
  -e HOST_OS="Unraid"
  -e HOST_HOSTNAME="Vader"
  -e HOST_CONTAINERNAME="bookstack"
  -e 'APP_URL'='http<s>://192.168.21.21:6875'
  -e 'DB_HOST'='172.25.0.10'
  -e 'DB_PORT'='3306'
  -e 'DB_USER'='admin'
  -e 'DB_PASS'='admin'
  -e 'DB_DATABASE'='wiki'
  -e 'QUEUE_CONNECTION'=''
  -e 'PUID'='99'
  -e 'PGID'='100'
  -e 'UMASK'='022'
  -l net.unraid.docker.managed=dockerman
  -l net.unraid.docker.icon='https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/bookstack-logo.png'
  -p '6875:80/tcp'
  -v '/mnt/user/appdata/bookstack':'/config':'rw' 'lscr.io/linuxserver/bookstack'
e822764e195c12f202172defc2b9acfe43fb1fb5ad543d550fc1ff9570885069

 

Any help appreciated

Edited by GM_XIII

  • 1 year later...
On 12/10/2023 at 10:01 AM, GM_XIII said:

Having same issues as above.

 

Here is my docker log:

 

[migrations] started
[migrations] 01-nginx-site-confs-default: skipped
[migrations] 02-default-location: skipped
[migrations] done
───────────────────────────────────────

      ██╗     ███████╗██╗ ██████╗ 
      ██║     ██╔════╝██║██╔═══██╗
      ██║     ███████╗██║██║   ██║
      ██║     ╚════██║██║██║   ██║
      ███████╗███████║██║╚██████╔╝
      ╚══════╝╚══════╝╚═╝ ╚═════╝ 

   Brought to you by linuxserver.io
───────────────────────────────────────

To support LSIO projects visit:
https://www.linuxserver.io/donate/

───────────────────────────────────────
GID/UID
───────────────────────────────────────

User UID:    99
User GID:    100
───────────────────────────────────────

using keys found in /config/keys
App Key found - setting variable for seds
Running config - DB_HOST set
**** APP_URL in /config/www/.env is being updated from 192.168.21.21 to http<s>://192.168.21.21:6875 ****
**** If this is an existing install, you should run the following line from your host terminal to update the database URL entries: ****
************************************************************************
docker exec -it bookstack php /app/www/artisan bookstack:update-url 192.168.21.21 http<s>://192.168.21.21:6875
************************************************************************
Waiting for DB to be available

   INFO  Nothing to migrate.  

[custom-init] No custom files found, skipping...
[ls.io-init] done.

 

Docker template:

docker run
  -d
  --name='bookstack'
  --net='wiki'
  -e TZ="Europe/London"
  -e HOST_OS="Unraid"
  -e HOST_HOSTNAME="Vader"
  -e HOST_CONTAINERNAME="bookstack"
  -e 'APP_URL'='http<s>://192.168.21.21:6875'
  -e 'DB_HOST'='172.25.0.10'
  -e 'DB_PORT'='3306'
  -e 'DB_USER'='admin'
  -e 'DB_PASS'='admin'
  -e 'DB_DATABASE'='wiki'
  -e 'QUEUE_CONNECTION'=''
  -e 'PUID'='99'
  -e 'PGID'='100'
  -e 'UMASK'='022'
  -l net.unraid.docker.managed=dockerman
  -l net.unraid.docker.icon='https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/bookstack-logo.png'
  -p '6875:80/tcp'
  -v '/mnt/user/appdata/bookstack':'/config':'rw' 'lscr.io/linuxserver/bookstack'
e822764e195c12f202172defc2b9acfe43fb1fb5ad543d550fc1ff9570885069

 

Any help appreciated

If you are still having issues, the docker was updated to say DB_USERNAME and DB_PASSWORD instead. I also had issues is if you change the password you might have to rebuild MARIADB to get it work as it just saves it the once and then doesn't update afterwards.

Also i am trying to get the Email/Google login allowance to work so that my users can create their own accounts. I notice i need to add to the .env file, however when i go to that file in appdata its everything to default meaning it does not match my Docker compose settings. Do i need to add a new variable one by one in Unraid docker to get it work? Or can i edit the .env and add what i need? any help would be appreciated!

  • 6 months later...

Just an update about this docker container because I encountered errors that drove me mad, trying to figure it all out.

  1. Docker only supported in BRIDGE mode, assigning it to br0, with static IP, connections to port 6875 just fail. Don't know why, and I simply gave up.

  2. Needs a MariaDB Docker in BRIDGE mode, can't ping or reach MariaDB docker with static IP in br0. Again, don't know why, I just had to create a Bridged MariaDB exclusively for Bookstack

  3. When Entering APP Key, you must include 'base64:jjfsakhjklksdhkjkhkfsff......' you have to include base64 in the App Key, the docker will error out. Reddit post explained this issue, surprised no one mentioned it here.

I didn't create a docker network, or some other ways for Bookstack talk to communicate with MariaDB docker, but this was a BIG issue. I wanted to Bookstack and use a static IP with br0. I couldn't get it to work, any port I assigned (6875) just refused to accept traffic to the port. I gave up.

I had to settle with installing this thing in BRIDGE.

Its working, testing.

I really hope this post helps anyone struggling to get this docker installed and work properly.

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.