Install Fleio with Docker (beta)

Important

Fleio deployment with docker is in beta phase and is not recommended for production.

However, docker deployment will become the recommended method to install Fleio and in the following months all other deployment methods (deb/rpm system packages) will be deprecated. And Docker deployment will be the only method to deploy Fleio.

We encourage all clients to test this method in a non-production environment.

If you are installing Fleio in a production environment, you should use one of the system packages deploy methods.

Linux distributions and versions supported by Fleio docker deployment:

  • Ubuntu 18.04
  • Ubuntu 20.04
  • CentOS 8

Fleio docker installation script should work on any Linux that has bash, runs systemd and is supported by docker and docker-compose, but we’re actively testing the above distros. We recommend you use one of the supported Linux flavors.

It is recommended to install Fleio on a clean, newly deployed machine that is not running other services. This avoids possible conflicts (e.g. the fleio user created automatically must have UID 625 and the fleio group GID 625).

Update all system packages before proceeding (e.g. apt update && apt upgrade or dnf upgrade).

You also need bash, curl and sudo installed.

You will be asked the license ID (a 16 characters string, e.g. yupn5yilio3qiquw) and the license key (e.g. WERPWM24HV7PUADHXYBJOIL2LMJVCYYCXORA2CH0EIX===) during the installation process. You will receive the licensing details after purchasing a license. Note that for every purchased license you are also entitled to an additional license for a non-production environment (staging or development).

Install Fleio in one step

To install Fleio just run the following command:

curl -s -o install https://fleio.com/install && sudo bash install

This will install docker and docker-compose (if not already installed), will create the fleio local user and group and create all the configuration files needed to run Fleio via docker-compose.

You can inspect the docker-compose configuration at /home/fleio/compose/docker-compose.yml, but DO NOT edit this file as it may be overwritten on Fleio upgrades.

You can add customizations in file /home/fleio/compose/docker-compose-local.yml this will not be overwritten by Fleio and it is already included when you run a fleio command or docker-compose command (through directive COMPOSE_FILE=docker-compose.yml:docker-compose-local.yml from file .env).

If you want to know more about what the docker Fleio deployment script does, see Fleio docker deployment notes.

Limitations of Fleio deployment with docker

  • The docker deployment of Fleio does not include reseller frontend files in the 2020.10 release. This limitation has no impact if you are not using the Fleio resellers feature.
  • The docker Fleio deployment does not provide HTTPS out of the box, but can be manually configured with a proxy on the host or another containers that handles the SSL connection. Future version will include an automatic Let’s Encrypt certificate deployment.
  • A segmentation fault occurs when refreshing the Fleio license. It should be harmless.
  • Frontend customization no longer works with docker and it will be totally obsolete in a few months. The only supported method to customize the frontend code will be Example: add custom CSS and Google Analytics.