BookStack Logo

Installing Bookstack wiki on AWS free instance.

Spread the love

This guide is how I installed Bookstack Wiki on my AWS Free instance Ubuntu 20.04 server:

Bookstack has a handy Ubuntu 20.04 Installation script that can be run on a fresh install of Ubuntu 20.04 to automatically install Bookstack and the prerequisite software needed for it to run (Apache, MySQL 8.0 & PHP-7.4).

The script can be found at: https://www.bookstackapp.com/docs/admin/installation/

The process is really simple but for some reason the page has been locked so you can not copy and paste from it!:

Download the script by running:

https://raw.githubusercontent.com/BookStackApp/devops/master/scripts/installation-ubuntu-20.04.sh

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 1

Change the downloaded script to make it executable:

chmod a+x installation-ubuntu-20.04.sh

You will now see that the script is executable:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 2

Run the script by running:

sudo ./installation-ubuntu-20.04.sh

The script will then ask for the fqdn so add what you would like the site to be called. I used wiki.ithowtoo.com and pressed enter.

Let the script run.

It will ask if you want to run Composer as root/super user:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 3

I chose Yes as its the only user I have and the install continued:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 4

When the script has finished you will see a similar message to the one below:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 5

From the ASW interface an inbound rule was created to allow https:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 6

You will then be able to get to the login page:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 7

Login using the default user and password given by the script:

User Email = admin@admin.com

password = password

On first login you will be advised to change the default password for security reasons:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 8

Click OK.

To edit the Admin user details click on Admin in the top left corner of the page:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 9

Select Edit Profile:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 10

Edit the details to your details:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 11

Click save to save the details:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 12

You will now see your new user in the list of users as an Admin:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 13

Click on the user icon in the top left corner of the page and select Logout to log out of the page and then log in with the new user to make sure everything works as it should:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 14

I have also setup a new A record for wiki.mydomain to point to the external IP address of the server so that I can access the site via wiki.domain instead of the external IP address.

The final security measure is to set the mysql root password as it is not setup by default.

Log into mysql by typing:

mysql

You will then see the mysql prompt:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 15

Type the following to set the root password to password:

ALTER USER 'root'@'localhost' IDENTIFIED BY 'PASSWORD';
Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 16

Obviously you will want to change the PASSWORD to something more secure.

You will then need to quit mysql by typing quit. This will take you back to the normal command line:

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 17

At the command prompt stop the MySQL daemon by typing:

sudo systemctl stop mysql

With the daemon stopped issue the following command:

sudo mysqld -init-file=~/mysql-pwd

Start the daemon:

sudo systemctl start mysql

You should now be able to access mysql using the root user by typing:

mysql -u root -p

Installing Bookstack wiki on AWS free instance.
Installing Bookstack wiki on AWS free instance. 18

You have now successfully installed Bookstack on an AWS free instance.

For more documents on Bookstack configuration go click HERE.

2 thoughts on “Installing Bookstack wiki on AWS free instance.”

  1. Avatar of Badaloni74

    Hi Ithowtoo.

    I did the same than you, and when the script finished (without errors) I saw a similar message than you but, when I traid to connect to bookstack, by site or by IP, I see
    “Can’t access this website” message.

    In Network ACLs I created an inbound rule type HTTP (and HTTPS later), but I can’t connect to bookstack. 🙁

    Any idea?

    Thanks

Leave a Comment

Your email address will not be published. Required fields are marked *

Scroll to Top