Install BookStack on Fedora 27



  • Thank you @JaredBusch for the excellent write up. I followed your instructions (copy and paste after editing the first section only) and did not receive any errors, however when I navigate to fqdn, it directs me to a page cannot be found page. Looking at the url it looks like is is appending the url twice.

    For example:
    I enter wiki.example.com
    and it navigates me to wiki.example.com/http:/wiki.example.com/login

    If I manually go to wiki.example.com/login I get a login page that is missing images.

    0_1519247086672_65e63e4c-d9c5-49bd-b0d3-87c79893b894-image.png

    Any thoughts?



  • @i3 said in Install BookStack on Fedora 27:

    Thank you @JaredBusch for the excellent write up. I followed your instructions (copy and paste after editing the first section only) and did not receive any errors, however when I navigate to fqdn, it directs me to a page cannot be found page. Looking at the url it looks like is is appending the url twice.

    For example:
    I enter wiki.example.com
    and it navigates me to wiki.example.com/http:/wiki.example.com/login

    If I manually go to wiki.example.com/login I get a login page that is missing images.

    0_1519247086672_65e63e4c-d9c5-49bd-b0d3-87c79893b894-image.png

    Any thoughts?

    Check the APP_URL in your .env file.

    grep APP_URL /var/www/html/bookstack/.env
    

    You should see something like this
    0_1519247534365_6b542851-7a0a-47c5-b781-b4363796142c-image.png



  • When I did that it showed app_url=http:\wiki.example.com
    I edited it to show http:// and it is now working- thank you very much for the quick response!

    I went back to my original file of what I entered in the app_url and I entered 'http:\wiki.example.com'

    Did I do something wrong?



  • @i3 said in Install BookStack on Fedora 27:

    When I did that it showed app_url=http:\wiki.example.com
    I edited it to show http:// and it is now working- thank you very much for the quick response!

    I went back to my original file of what I entered in the app_url and I entered 'http:\wiki.example.com'

    Did I do something wrong?

    Yes. You have to escape the / with a \ to make the script work.
    Look at the note I had there.

    # Note 2: You must escape the // hence \/\/
    export APP_FQDN='http:\/\/wiki.domain.com'
    


  • Got it. I misunderstood and simply removed the two //

    I understand now.

    Again, thank you for the great write up and responses!



  • Yup, loving it.

    0_1519341548488_a1ca4829-39ae-40a7-b7d4-e0cf6b87f406-image.png

    When you export to PDF, you get a log at the bottom too.
    0_1519341594125_8b620af0-6098-4a71-8ae3-f4af8d2ed2a5-image.png



  • @JaredBusch Nice write-up. I am definitely going to be trying this soon.



  • This post is deleted!


  • Woop installed and ready to use.

    (Does it matter i have no idea what half those commands did, but yet i have a working system πŸ€” )



  • @hobbit666 said in Install BookStack on Fedora 27:

    Woop installed and ready to use.

    (Does it matter i have no idea what half those commands did, but yet i have a working system πŸ€” )

    I guess that was the point of the post, was to make it crazy simple. I suppose whether it matters if you have no idea or not depends on whether you want to learn what those commands do or not πŸ˜‰



  • Seem to have an issue with pages.
    Can add a new one but with no details
    0_1519654967201_layout.png

    But if i change the heading or add some text both editing the Page or when i first create one i get:-
    0_1519655017224_error.png

    So creating a New Book and Chapter works fine



  • @hobbit666 ignore me rebooted now working



  • @nashbrydges said in Install BookStack on Fedora 27:

    @hobbit666 said in Install BookStack on Fedora 27:

    Woop installed and ready to use.

    (Does it matter i have no idea what half those commands did, but yet i have a working system πŸ€” )

    I guess that was the point of the post, was to make it crazy simple. I suppose whether it matters if you have no idea or not depends on whether you want to learn what those commands do or not πŸ˜‰

    That is the point of my guides. They are for both education and getting a working system.

    I could easily make it a script like @scottalanmiller did to my Nextcloud 13 guide, but I don’t want to.

    I want my guides to educate as well as get the job done. I think the way that I breaks them up with a little blurb in between each set helps give it that right balance. Too much text and people who do not want to learn just move on. Not enough text, and it is basically just a script and the person learns nothing.



  • @jaredbusch said in Install BookStack on Fedora 27:

    @nashbrydges said in Install BookStack on Fedora 27:

    @hobbit666 said in Install BookStack on Fedora 27:

    Woop installed and ready to use.

    (Does it matter i have no idea what half those commands did, but yet i have a working system πŸ€” )

    I guess that was the point of the post, was to make it crazy simple. I suppose whether it matters if you have no idea or not depends on whether you want to learn what those commands do or not πŸ˜‰

    That is the point of my guides. They are for both education and getting a working system.

    I could easily make it a script like @scottalanmiller did to my Nextcloud 13 guide, but I don’t want to.

    I want my guides to educate as well as get the job done. I think the way that I breaks them up with a little blurb in between each set helps give it that right balance. Too much text and people who do not want to learn just move on. Not enough text, and it is basically just a script and the person learns nothing.

    Learn by doing is an axiom for me.



  • @JaredBusch Just curious, where do you have this located for your internal documentation? On a VPS like Vultr, or do you have this in your own COLO somewhere? I want to deploy bookstack this weekend to check it out and am trying to decide where to put it.



  • @fuznutz04 said in Install BookStack on Fedora 27:

    @JaredBusch Just curious, where do you have this located for your internal documentation? On a VPS like Vultr, or do you have this in your own COLO somewhere? I want to deploy bookstack this weekend to check it out and am trying to decide where to put it.

    Mine is in a colo. We have a server there, it would be silly not to use it.

    Our PBX is on vultr, because that should not go down because I change something in the colo like a fucking genius (been there done that, got the tshirt).

    But things like our Nextcloud, Wiki, UNMS, UniFi Controller, etc. those can reside on the colo more cost effectively. At least until I need to upgrade the hardware.



  • @jaredbusch Good to know. Our PBX is Vultr as well, for the same reason. But in our office (not COLO) we host some internal stuff, and I have room for another VM as well. I'm debating on just hosting the wiki at the office, or putting it on Vultr. The downside of hosting at an office is that there are no redundancies for power or internet.



  • @fuznutz04 said in Install BookStack on Fedora 27:

    @jaredbusch Good to know. Our PBX is Vultr as well, for the same reason. But in our office (not COLO) we host some internal stuff, and I have room for another VM as well. I'm debating on just hosting the wiki at the office, or putting it on Vultr. The downside of hosting at an office is that there are no redundancies for power or internet.

    That would only be a problem if you don't have the chapter named "What do do when the power goes out" saved as a PDF somewhere, lol.



  • @JaredBusch I got this up and running. I like it so far. Then I attempted to use cert bot to secure it, and somehow screwed it up. I do not have a reverse proxy in front of bookstack. What else needs to be changed in the config files? I'm almost there, but the page is now displaying "The site cant provide a secure connection." wiki.mysite.com sent an invalid response.

    So it's getting to the site, but something is off.



  • @fuznutz04 OK Getting somewhere. Now getting the default Apache test page . So I'm getting to the server, but not getting to Bookstack.



  • @fuznutz04 said in Install BookStack on Fedora 27:

    @fuznutz04 OK Getting somewhere. Now getting the default Apache test page . So I'm getting to the server, but not getting to Bookstack.

    https://mangolassi.it/topic/16471/install-bookstack-on-fedora-27/3



  • Got it. I had the wrong path in the /etc/httpd/conf.d/ssl.conf file. I was pointing the document root to /var/www/html/bookstack instead of /var/www/html/bookstack/public.

    Time for a drink.



  • Spoke too soon. I was only able to get to the home page. Clicking anything else like Settings, or books, give mes:

    Not Found
    The requested URL /books was not found on this server.



  • It is certainly a problem with the ssl.conf. Make sure the options match the bookstack.conf



  • Also you have to update the .env file



  • @jaredbusch said in Install BookStack on Fedora 27:

    It is certainly a problem with the ssl.conf. Make sure the options match the bookstack.conf

    My frustrations got in the way, and I forgot to put in the Directory lines.

    <Directory /var/www/html/bookstack/public>
            Require all granted
            AllowOverride All
            #Options +Indexes
    </Directory>
    
    

    Good to go! Can't wait to start populating content in this to see how I really like it.



  • Log file path in the bookstack.conf updated to keep SELinux happy.
    Here is the fix if you have a problem after a reboot and followed these instructions originally prior to the date of this post.

    https://mangolassi.it/topic/16587/fedora-update-breaks-httpd/12



  • Hi everyone,

    i just registered here to say thank you for this awesome step-by-step tutorial! πŸ™‚
    I use bookstack in my virtualbox VM with NAT network settings and i just had to use "#" for "APP_URL" in order to use http://localhost inside of the VM. πŸ™‚

    One big problem i have is the maintenance. In order to backup the database i have to use the MariaDB root password, which somehow isn't the one i used to install bookstack. Whenever i try to change the root password my database gets wrecked so hard that i have to restore old snapshots in order to systemctl start mariadb again.

    i stoped mariadb then used mysqld_safe --skip-grant-tables & and then connected to mysql and changed the root password with SQL statements. After that the database is unusable. 😞

    Any idea? πŸ˜•



  • @cherryman said in Install BookStack on Fedora 27:

    Any idea? πŸ˜•

    When installing BookStack, you don't want to use the root account for it to run, that would be the underlying issue. You'll want to make a new user that is dedicated to BookStack, set it with its own password and give it access only to the BookStack database. Then once the app is talking to the database using that account, you are free to use that account as well to make your backups, to make a separate account for backups, or to use the root account for backups. But you'll want to make sure that root is not the one being used by the application.



  • @scottalanmiller
    Thank you for clarifying. πŸ™‚
    Just following the tutorial from @JaredBusch there is already a dedicated database_user just for the application.
    So there is no security issue for me. Luckily the Bookstack_db_user works when I try to export the database. It's just odd that the root password i used for mysql doesn't work at all. aslong as the bookstack DB_user is enough as DB_Backup then i am happy with it. πŸ™‚

    Thanks alot! πŸ™‚