For the complete documentation index, see llms.txt. This page is also available as Markdown.

Installation

As a Go program, fylr supports many platforms. For some installation scenarios, we prepare instructions and tools:

Please note: We do all of our automated and manual software testing based on Linux servers. There is no dedicated testing on Windows and almost no testing on Kubernetes.

Linux

  • Instructions and Requirements: Linux

  • Uses docker-compose.

  • 3rd party tools for thumbnails are pre-packaged.

  • If unsure, use this method when installing yourself.

  • We offer maintenance contracts and hosting contracts for this variant. Contact us at e.g. support@programmfabrik.de.

Windows

  • Instructions and Requirements: Windows

  • We provide a list of 3rd party tools for thumbnails but not the tools themselves.

  • Some of our partners offer maintenance contracts for this variant.

Kubernetes

  • Instructions: See our helm chart.

  • Requirements:

    • Uses Helm charts and Linux containers.

    • Needs Helm and a Kubernetes cluster.

  • Features:

    • Third-party tools for thumbnails are pre-packaged.

    • A fylr instance can be started as many times as desired. Load balancing is handled externally (e.g., by a load balancer), not by fylr itself. All instances run in parallel, equally privileged, and share a common database.

    • A fylr instance can also be configured to act only as an execution server. In such cases, its fylr.yml does not configure an API/web server, and it does not require a database. fylr servers notify the execution server when they have jobs to process. Horizontal scaling is most beneficial in this configuration.

  • Licensing Notes: You need the fylr edition Organization to run fylr in a kubernetes environment.

  • Monitoring: Every fylr instance shows how many others are currently connected in parallel.

  • Support: We offer no support for this variant, only bug fixes for issues reported to ​support@programmfabrik.de.

Topics for all variants

Software Versions

  • We are regularly testing fylr with Opensearch 3 and PostgreSQL 18 and recommend them with fylr. Customers with problems and earlier versions may be asked to upgrade first.

Download binaries

From fylr 6.34.0, the downloadable macOS, Windows and Linux binaries are compiled without cgo: they are statically linked and use the pure-Go SQLite driver, so they run on any host of their platform without a C toolchain or extra system libraries. The official Docker image is unchanged — it keeps cgo and the C-based SQLite driver — and PostgreSQL deployments are unaffected either way.

Troubleshooting

fylr log messages that can be ignored

Last updated