DEV Community

Aastha Shrivastava
Aastha Shrivastava

Posted on

Automating Virtual Host setup on your server

Are you also one of those who frequently need to setup VHosts in order to test,create etc new sites and you feel doing the whole process again and again is time consuming and well.. BORING? Then this article is for you!

Note: The script used in this article is written for any Linux distro with Apache server, but you may still get a general idea of how to use it for your requirements.

Here we will create a simple bash script to automate the whole vhost setup process which includes:

  • Creating a new folder for your website.
  • Creating configuration files for the website.
  • Configuring the hosts file and
  • Enabling the vhost.

Creating template files

Before we start working on our script we will need these template files which we use in the setup:

  • A template conf file to create configuration for the vhost.
  • A template index.html file for default homepage of our newly created vhost

This is how my template files looks like:
default-index.html

 <html>
   <head>
     <title>Home|New Virtual Host</title>
   </head>
   <body>
        <h1>Welcome!</h1> 
        You just created a new virtual host!<br>
        Go ahead and add some files in your brand new vhost
   </body>
 </html>
Enter fullscreen mode Exit fullscreen mode

default-vhost.conf

<VirtualHost *:80>
        ServerName 127.0.0.x
        ServerAlias example.local
        ServerAdmin admin@example.local
        DocumentRoot /var/www/example.local

        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
Enter fullscreen mode Exit fullscreen mode

You can create similar files based on your requirements.

Now let's get started with the script.

Getting sitename and host from command line

Let's start by getting the input parameters as command line arguments. We will use the flags:

  • -s: for sitename
  • -h: for host

We will also use a flag -d (optional) in case user wants to create a new project directory for the vhost.

We will use getopts to get the arguments, if you are not familiar with getopts you can check out this article.

This is how we can take input from command line:

while getopts s:h:d flag
do
case "${flag}" in
                s) sitename=${OPTARG}
                        ;;
                h) host=${OPTARG}
                         ;;
                d) createdir=1
                        ;;
 echo "Added entry in hosts file"
               *) echo "Invalid option: -$flag" ;;
        esac
done
Enter fullscreen mode Exit fullscreen mode

We are storing the values we got from input in sitename and host variable and setting createdir to 1.

Creating and configuring project directory

Next we will create a folder in /var/www and copy our default-index.html file in that folder:

if [[ $createdir -eq 1 ]]
then
  mkdir /var/www/$sitename
  cp default-index.html /var/www/$sitename/index.html
Enter fullscreen mode Exit fullscreen mode

We are checking if user has specified the -d flag or not, you can remove the condition if you always want create a new directory for your vhost. You can also skip this step depending on your requirement.

Now that we have created the directory let's change the owner to current logged-in user:

  chown $SUDO_USER:$SUDO_USER /var/www/$sitename
Enter fullscreen mode Exit fullscreen mode

This is because only the super user has permissions to create files and folders in var/www, so we are changing the owner of the folder so that the current user will have full control over the folder.

This script needs to be run using sudo, $SUDO_USER contains user name of user which is executing the script using sudo.

Now let's change the permission for

  chmod 755 /var/www/$sitename
fi
Enter fullscreen mode Exit fullscreen mode

Creating configuration files

Now we will create the conf file for our site in /etc/apache2/sites-available/ using or default template:

cd /etc/apache2/sites-available/
cp default-vhost.conf $sitename.conf
sed -i "s/example.local/$sitename/g" $sitename.conf
sed -i "s/127.0.0.x/$host/g" $sitename.conf
Enter fullscreen mode Exit fullscreen mode

Here sed or stream editor is a command line tool for editing, we are using sed to replace example.local with $sitename and 127.0.0.x with $host in our conf file.

Configuring hosts file

Currently your /etc/host must look like something like this :

127.0.0.1       localhost
.
.
.

# The following lines are desirable for IPv6 capable hosts
::1     ip6-localhost ip6-loopback
fe00::0 ip6-localnet
.
.
.
Enter fullscreen mode Exit fullscreen mode

We want to add the host and sitename before # The following lines are desirable... line. For this we will once again use the sed:

sed -i "0,/# The following lines are desirable for IPv6 capable hosts/s/^# The following lines are desirable.*/$host       $sitename\n&/" /etc/hosts
Enter fullscreen mode Exit fullscreen mode

Enabling virtual host and restarting the server

Now let's enable our vhost using a2ensite command and reload apache:

a2ensite $sitename.conf
systemctl reload apache2
echo "All done! Visit your newly created virtual host at https://example123.local"
Enter fullscreen mode Exit fullscreen mode

And that's it! Phew! We just created a simple script to automate vhost configuration. Let's go ahead and execute it:

sudo ./create-conf.sh -s example123.local -h 127.0.0.12 -d

All done! Visit your newly created virtual host at https://example123.local
Enter fullscreen mode Exit fullscreen mode

Let's visit our newly created virtual host
Alt Text

Here is how our full script looks like:

#!/bin/bash
while getopts s:h:d flag
do
case "${flag}" in
                s) sitename=${OPTARG}
                        ;;
                h) host=${OPTARG}
                         ;;
                d) createdir=1
                        ;;
                *) echo "Invalid option: -$flag" ;;
        esac
done
# Create and configure folder in `/var/www` if option if option selected
if [[ $createdir -eq 1 ]]
then
  mkdir /var/www/$sitename
  echo "Folder /var/www/$sitename created"
  # Creating dummy landing page
  cp default-index.html /var/www/$sitename/index.html
  echo "Intitialized with index page"

  # Changing owner and permission of the folder
  chown $SUDO_USER:$SUDO_USER /var/www/$sitename
  chmod 755 /var/www/$sitename
  echo "Modified permissions and owner"
fi
# Creating configuration files
cd /etc/apache2/sites-available/
cp default-vhost.conf $sitename.conf
sed -i "s/example.local/$sitename/g" $sitename.conf
sed -i "s/127.0.0.x/$host/g" $sitename.conf
echo "Configuration files created"

# Configuring hosts file
sed -i "0,/# The following lines are desirable for IPv6 capable hosts/s/^# The following lines are desirable.*/$host       $sitename\n&/" /etc/hosts
echo "Added entry in hosts file"

# Enabling virtual host and restarting the server
a2ensite $sitename.conf
systemctl reload apache2
echo "Restarted apache"
echo "All done! Visit your newly created virtual host at https://$sitename"
Enter fullscreen mode Exit fullscreen mode

Final Thoughts

Though this script may not fully work with your requirement you can definitely get an idea of how to make one for yourself do let me know in the comments what you think about it!

References:

Setting up Virtual Host on Ubuntu 20
Taking command line arguments using flags in bash
Stream Editor to insert line
How to use sed to find and replace text in files in Linux / Unix shell

Top comments (1)

Collapse
 
fenix profile image
Fenix •

Thanks for sharing !

Read next

lionel_velloz_cdb24c6956c profile image

ABOUT Lionel Velloz!

Lionel Velloz -

zhangwuji profile image

windows computer setting

Zhangwuji -

solleedata profile image

Making Shared ESLint, Prettier Config Files

Sol Lee -

raffaeleloi profile image

Building better softwares: The power of building effective abstraction

Raffael Eloi -