Skip to main content

Run with Docker

Flexify.IO command line engine is packaged in container images available on Docker Hub:

flexifyio/engine

The base Flexify.IO Engine container.

flexifyio/migrate

Equivalent to flexifyio/engine migrate

flexifyio/proxy

Equivalent to flexifyio/engine proxy

To run Flexify.IO command line in a container:

  • Instead of fl migrate <arguments> use docker run flexifyio/migrate <arguments>

  • Instead of fl proxy <arguments> use docker run -p 80:80 -p 443:443 flexifyio/proxy <arguments>

Permissions​

For OpenShift compatibility, flexifyio/engine container does not have USER statement and would run as a root user by default on Docker or Kubernetes.

To achieve stricter isolation it’s recommend to run flexifyio/engine user user flexify (uid=1001). The image supports:

  • Running as root (uid=0) user

  • Running as flexify (uid=1001) user

  • Running with random uid and gid=0 - used by OpenShift

Note that when mounting reports and logs directories and running under non-root user, host directories permissions should be set accordingly. For example:

mkdir -p logs reports
sudo chown -R 1001:1001 logs reports
docker run -p 80:80 \
-u flexify \
-v $(pwd)/logs:/var/log/flexify/engine \
-v $(pwd)/reports:/var/lib/flexify/engine/proxy_reports \
flexifyio/proxy \
--cloud AZURE \
--cloud-key-id <storage account name> \
--cloud-secret-key <storage account key> \
--report-level ALL