Ubuntu 16.04

This is the guide for installing Fleio on Ubuntu 16.04 distribution.

Important

This installation method will be retired in the first part of 2021.

And Fleio docker deployment will become the only method to install Fleio.

However, docker deployment is now in beta and therefore not recommended for production. If you’re installing Fleio in a testing environment we encourage you to use: Install Fleio with Docker (beta).

If you are installing Fleio in a production environment, use a system packages deploy method, like the one below.

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';

If you are seeing database related errors when installing or upgrading Fleio see Troubleshoot database errors on upgrade.

Bootstrap initial configuration

Now we need to bootstrap Fleio by running the following command:

/var/webapps/fleio/scripts/bootstrap

This script creates the database tables, creates the administrator user, the settings.py file, installs Nginx and configures it, and ensures that all the required services are up and running. 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.