Doesn't work. Apache fails to start. Fresh Ubuntu Server 20.04.3

[HubKing]

I used the ready-made virtual OS image ( https://www.osboxes.org/ubuntu-server ) of Ubuntu Server 20.04.3. I downloaded the script and ran. It asked for a domain name, but of course, as a typical home user, I do not have a domain name for my home network, so I just pressed enter. It said the installation is finished, but I could open the page. When I restarted the virtual OS, I could see an error message of Apache failing to start. But I did not do anything, and everything was done by the script. The only potential fault of mine could be not entering a domain name, but if so, why did the script continue?

[ssddanbrown]

Hi @HubKing,

It asked for a domain name, but of course, as a typical home user, I do not have a domain name for my home network, so I just pressed enter.

The only potential fault of mine could be not entering a domain name, but if so, why did the script continue?

This is the issue. BookStack is a web application. Even if used locally it would be accessed via a browser via a domain or IP address. The script requires this and will not stop if none is provided, We don't currently have error checking for someone not providing this.

This can be added after the fact if required, the domain is used in two places:

1. In the /var/www/bookstack/.env file. The APP_URL= line must be configured to be equal to your base app URL (APP_URL=http://docs.example.com for example).
2. In the /etc/apache2/sites-available/bookstack.conf file. The line starting ServerName must be set to your domain (ServerName docs.example.com for example). You'll need to restart apache after this change (sudo systemctl restart apache2)

[ssddanbrown]

I've now added a check to the Ubuntu20.04 install script to ensure that the lack of a domain stops the script early.

devops/scripts/installation-ubuntu-20.04.sh

Lines 15 to 21 in 152fcff

	# Ensure a domain was provided otherwise display
	# an error message and stop the script
	if [ -z "$DOMAIN" ]
	then
	>&2 echo 'ERROR: A domain must be provided to run this script'
	exit 1
	fi

Will therefore close this off.