Ubuntu 16.04

This is the guide for installing Fleio on Ubuntu 16.04 distribution. In our documentation, for simplicity reasons, we are going to install the backend and the frontend on the same server.

Run the commands below as root user.

Install prerequisites

apt-get update
apt-get install curl software-properties-common apt-transport-https

Import gpg public key

curl  https://repos.fleio.com/public.key | apt-key add -

Enable repository

add-apt-repository "deb [arch=amd64] https://repos.fleio.com/ubuntu xenial main"

Install the backend package

apt-get update
apt-get install fleio-backend

Install the frontend package

apt-get install fleio-frontend

Fleio needs a database server in order to operate. In this tutorial, we are going to use MariaDB-server but feel free to use any database server of your choice.

Install MariaDB-server

apt-get install mariadb-server

Create the database and the database user

We are using fleio as database and fleio as username.

Run the mysql command line client, and create the database and the username:

CREATE DATABASE fleio CHARACTER SET utf8;
GRANT ALL PRIVILEGES ON fleio.* TO 'fleio'@'localhost' IDENTIFIED BY 'HEREWETYPEPASSWORD';

Bootstrap initial configuration

Now that we have Fleio installed and we have the database prepared, we need to create the settings file in path /var/webapps/fleio/project/fleio/settings.py. You can create this file manually, based on the template file found at /var/webapps/fleio/project/fleio/settings.template or you can use a helper script to create the settings.py file.

To start the helper script run:

/var/webapps/fleio/scripts/bootstrap

This script creates the database tables, creates the administrator user and the settings.py file. Next you need to answer several questions. Note that the default values, which are usually fine, are in square brackets.

/var/webapps/fleio/scripts/bootstrap

 * URL to install Fleio at [http://12.34.56.78]:
 * Specify timezone [UTC]:
 * Enter mysql server ip [localhost]:
 * Enter mysql database name for fleio [fleio]:
 * Enter mysql username for fleio [fleio]:
 * Enter mysql password for username fleio: HEREWETYPEPASSWORD
 * Configuring SMTP...
 * Specify SMTP server [localhost]:
 * SMTP requires SMTP authentication ? y/n:
 If Yes:
    * Specify SMTP username:
    * Specify SMTP password:

 * Creating database scheme...
 * Done
 * Creating super user for staff...
 * Specify your first name:
 * Specify your last name:
 * Specify username:
 * Specify email:
 * Specify password:
 * Installing additional packages
 * Done

Please proceed to Configuring section.