installation on Ubuntu 16.04 with Apache2 is an Open Pource project that creates interfaces for displaying data from connected objects or performing actions (lighting lamps, driving relays …). is directly accessible from the internet but the free offer does not allow to own a private dashboard. In this tutorial, we will install on a mini PC running Ubuntu 16.04 LTS by running it with an Apache 2 web server.

Installing Apache 2

Apache 2 installs very easily with the apt-get command.

sudo apt-get update
sudo apt-get install apache2

Accept questions asked during installation. At the end of the installation, the Apache Web server starts automatically.

Installing on Ubuntu

Get sources from GitHub

Let’s start by installing git.

Sudo apt-get install git

An installation directory is created. It does not matter the location of the directory, install it for example in your user folder or in the Home.

Sudo mkdir /home/freeboard_io

We start download sources from GitHub

cd /home/freeboard_io
git clone

Creating a symbolic link to /var/www

The files of the website must be located (ideally by convention) in the folder /var/www. We will simply create a symbolic link that will allow the Apache server to find its children.

sudo -s
cd /var/www
ln -s /home/freeboard_io/freeboard freeboard_io

Configuring Freeboard_io for Apache

Now, you need to configure a new site to work with the Apache server. We start by creating a new site in the sites-availables folder.

sudo nano /etc/apache2/sites-available/freeboard_io.conf

Adapt the configuration to your needs and paste it into the configuration file

<VirtualHost *:80>
    DocumentRoot /var/www/iot
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

Save the configuration file with Ctrl + X and then O.

Now we make the site active with the command a2ensite

cd /etc/apache2/sites-available
sudo a2ensite freeboard_io.conf

In fact, the a2ensite command creates a symbolic link to the sites-enable directory.

It only remains to restart the Apache service to take into account the new modification.

sudo service apache2 restart

Configuring the Hosts File

It only remains to point the url to the site. To do this, retrieve the ip address of your machine with the ifconfig command and then open the /etc/hosts  file.

sudo nano /etc/hosts

Replace the IP address with that of your machine then save with CTRL+X then Y.       localhost

And now you can access freeboard from your browser using the address

freeboard ubuntu apache2 nginx

In the next tutorial, we’ll see how to run with Nginx.

Useful links :

Subscribe to the weekly newsletter

No spam and no other use will be made of your email. You can unsubscribe anytime.

  • Barry Miller

    I Can’t get it to work
    In the .conf file documentroot /var/www/iot
    is this correct and do I need to create it
    Regards Struggling Newbe

DIY Projects