DOCUMENTATION
  • Welcome
  • Releases
    • 2025
      • Release v6.20.2 (2025-05-07)
      • Release v6.20.1 (2025-05-06)
      • Release v6.20.0 (2025-04-30)
      • Release v6.19.2 (2025-04-11)
      • Release v6.19.1 (2025-03-31)
      • Release v6.19.0 (2025-03-27)
      • Release v6.18.2 (2025-03-11)
      • Release v6.18.1 (2025-03-07)
      • Release v6.18.0 (2025-02-26)
      • Release v6.17.3 (2025-02-14)
      • Release v6.17.2 (2025-02-07)
      • Release v6.17.1 (2025-02-06)
      • Release v6.17.0 (2025-01-30)
    • 2024
      • Release v6.16.0 (2024-12-12)
      • Release v6.15.0 (2024-11-27)
      • Release v6.14.2 (2024-11-05)
      • Release v6.14.1 (2024-11-01)
      • Release v6.14.0 (2024-10-31)
      • Release v6.13.3 (2024-10-16)
      • Release v6.13.2 (2024-10-10)
      • Release v6.13.1 (2024-10-02)
      • Release v6.13.0 (2024-09-25)
      • Release v6.12.2 (2024-09-18)
      • Release v6.12.1 (2024-08-01)
      • Release v6.12.0 (2024-07-25)
      • Release v6.11.5 (2024-07-09)
      • Release v6.11.4 (2024-07-05)
      • Release v6.11.3 (2024-07-03)
      • Release v6.11.2 (2024-06-21)
      • Release v6.11.1 (2024-06-14)
      • Release v6.11.0 (2024-06-05)
      • Release v6.10.2 (2024-05-15)
      • Release v6.10.1 (2024-05-08)
      • Release v6.10.0 (2024-04-30)
      • Release v6.9.3 (2024-03-19)
      • Release v6.9.2 (2024-03-15)
      • Release v6.9.1 (2024-03-06)
      • Release v6.9.0 (2024-02-28)
      • Release v6.8.5 (2024-02-02)
      • Release v6.8.4 (2024-02-01)
      • Release v6.8.3 (2024-01-12)
      • Release v6.8.2 (2024-01-05)
    • 2023
      • Release v6.8.1 (2023-12-22)
      • Release v6.8.0 (2023-12-14)
      • Release v6.7.4 (2023-11-15)
      • Release v6.7.3 (2023-11-14)
      • Release v6.7.2 (2023-11-03)
      • Release v6.7.1 (2023-10-17)
      • Release v6.7.0 (2023-10-13)
      • Release v6.6.4 (2023-09-29)
      • Release v6.6.3 (2023-09-28)
      • Release 6.6.2 (2023-09-14)
      • Release v6.6.1 (2023-08-10)
      • Release v6.6.0 (2023-08-03)
      • Release v6.5.1 (2023-06-23)
      • Release v6.5.0 (2023-06-22)
      • Release v6.4.0 (2023-05-31)
      • Release v6.3.1 (2023-04-28)
      • Release v6.3.0 (2023-04-05)
      • Release v6.2.5 (2023-03-16)
      • Release v6.2.4 (2023-02-01)
      • Release v6.2.3 (2023-01-12)
      • Release v6.2.2 (2023-01-12)
      • Release v6.2.1 (2023-01-05)
    • 2022
      • fylr first Production Ready Release 🎉 (2022-12-22)
  • License
  • Help
    • FAQs
    • Tutorials
      • For Users
      • For Administrators
        • Exporting & Importing Hierarchical Lists
        • Regenerating preview images
        • Search Text in images or office files
      • For System Administrators
        • How to setup and use IIIF
        • External access: Sharing collections with anonymous users
    • Glossary
  • FOR USERS
    • Getting Started
    • Asset / Records Management
      • Creating Records
      • Editing Records
        • Input Fields
        • Group Editor
      • Deleting Records
    • Quick Access
      • Collections (& Presentations)
      • Saved Searches (& Lists)
    • Lists
    • Plugins
      • Plugin Overview
  • FOR ADMINISTRATORS
    • Permissions
      • User
      • Groups
      • Object Types
      • Pools
      • Tags & Workflows
      • Presets
    • Tools
      • CSV Importer
        • General Information
        • Options
        • Examples
          • All Data Types
          • Lists
          • Hierarchies
          • Files
      • JSON Importer
        • Step-by-Step Tutorial
          • Write Import Manifest
          • Create Basetype Payloads
          • Create Object Payloads
          • Collection Payloads
          • Optional: Update links between Objects
          • Start Import
      • Permissions Download & Upload
    • Base Configuration
      • General
      • Access
      • User Management
      • Languages
      • Email
      • Export & Deep Links
      • Workflow Webhooks
      • Publications
      • File Worker
        • Preview Configuration
        • Location Defaults
        • Custom .icc Color Profiles
      • Objectstore
      • Services
      • License Management
      • Development
      • Plugins
    • Plugin Manager
    • Location Manager
    • Messages
    • Events
    • Backup Manager
    • Additional Features
      • IIIF
      • Connector
      • Wordpress
      • Zooniverse
      • Protocols
        • OAI/PMH
  • FOR SYSTEM ADMINISTRATORS
    • Installation
      • Linux
        • multiple fylrs in one Linux
        • proxy and fylr
      • Windows
      • Kubernetes
    • Configuration
      • fylr.example.yml
      • fylr.default.yml
      • performance tuning
      • pre-load frontend config
      • Load Custom Plugins
      • HTTP and HTTPS
      • DNS Domains
    • Backups & Restore
    • Migration Tool
      • Create payloads (fylr backup)
      • Insert payloads (fylr restore)
      • Best Practice
      • Using the fylr inspect page
    • Integration
      • Authentication
      • Hotfolder
    • Symptom & Solution
      • Log messages that can be ignored
      • too many clients are connected
      • too many nested clauses
      • context canceled
      • ContainerConfig error
      • Purge objects
    • PostgreSQL versions
  • Tutorials
    • Project Workflow
    • Hotfolder & File System Connect
      • Preparations Before Usage
      • Setting Up An Upload Collection
      • Importing Files
    • PDF Creator
    • Extracting File Metadata Later On
    • Overlay Resource
    • Authentication
      • LDAP
      • SAML
    • Data Model Sync
    • Purge a fylr instance
    • typo3 plugin
    • Use fylr in Google docs via CI HUB
  • FOR DEVELOPERS
    • API
      • OAuth2
      • Endpoints
        • /api/collection
        • /api/config
        • /api/db_info
        • /api/db
        • /api/eas
        • /api/event
        • /api/export
        • /api/group
        • /api/l10n
        • /api/mask
        • /api/message
        • /api/oaipmh
        • /api/objects
        • /api/objecttype
        • /api/plugin
        • /api/pool
        • /api/publish
        • /api/right
        • /api/schema
        • /api/search
        • /api/settings
        • /api/suggest
        • /api/system
        • /api/tags
        • /api/transitions
        • /api/user
        • /api/webdav
        • /api/xmlmapping
        • /api/task
    • System Data Types
      • pool
      • file
      • user
      • group
      • pool
      • collection
      • message
      • publish
      • event
    • User Data Types
      • text, text_oneline
      • string
      • text_l10n, text_l10n_oneline
      • boolean
      • number
      • integer.2
      • double
      • date, datetime
      • daterange
      • geojson
    • Custom Data
    • Emails
    • Export
    • Exec server
    • File versions
    • WebDAV
    • Plugin
    • Collection Pin Code
    • easydb 5
    • Localization
    • Access private Repositories
Powered by GitBook
On this page
  • Download fylr.exe
  • Windows path length
  • Get the dependencies
  • OpenSearch
  • Elasticsearch
  • Start fylr with minimal dependencies
  • More than bare bone minimum
  • PostgreSQL
  • pdf tools
  • magick.exe and convert.exe and composite.exe
  • Exiftool.exe
  • Ffmpeg.exe and ffprobe.exe
  • Node
  • Python
  • Java
  • Saxon
  • Ghostscript
  • Libreoffice
  • Inkscape
  • tika
  • tesseract
  • mupdf tools
  • dot
  • calibre
  • chrome
  • Configure the tools in fylr.yml
  • Start fylr as a service
  1. FOR SYSTEM ADMINISTRATORS
  2. Installation

Windows

How to install fylr on Microsoft Windows

Previousproxy and fylrNextKubernetes

Last updated 29 days ago

There are now two ways to do this:

  • The fully automated installer made by Attention Solutions: - needs a paid subscription with Attention Solutions.

  • Use fylr directly from the developer Programmfabrik GmbH and download the 3rd party tools by yourself. This is what the rest of this page guides you through:

Download fylr.exe

  • Go to the newest release in

  • Download fylr_v6.X.Y_windows_amd64.zip and unpack.

It contains:

  • fylr.exe fylr native for Windows amd64.

  • fylr.yml a starting configuration already adjusted with Windows path syntax and for the following instructions.

  • fylr.example.yml most configuration parameters. Look here for reference.

  • fylr.default.yml compiled-in default values. Just as a copy for you to look them up.

  • LICENSE legal information on who may use fylr.

  • A folder with plugins.

Windows path length

The shorter the path of your fylr installation directory, the less likely your installation will fail processing files due to exceeding the . So prefer C:\fylr over C:\user\jane doe\Desktop\software-project\fylr-v6.17.0\unpacked. fylr newer than v6.3.1 will try to use only short internal file names, but every little bit helps. Same for Libre Office installation (more about that below).

Get the dependencies

Bare bone minimum: Elasticsearch or OpenSearch

OpenSearch

OpenSearch is our default and recommendation.

  • Version 2.11 (Version 2.12.0 works from fylr v6.9.0 onwards, make sure you set a strong initial password for admin, the OpenSearch user)

  • We disabled security and let it explicitly listen only on localhost, thus protecting it:

network.host: 127.0.0.1
plugins.security.disabled: true
  • We installed the one needed plugin:

opensearch-2.11.0> .\bin\opensearch-plugin install analysis-icu

Elasticsearch

Elasticsearch has been the default until 2023. Now we recommend OpenSearch instead.

What we tested:

  • We recommend Elasticsearch 7.17.

  • If you start a new instance or have problems with ElasticSearch, we recommend OpenSearch, see above.

  • Since writing the next lines, we found a problem with Versions 8.5 and newer, about indexing letters Q and W, of all things. Thus our recommendation for Elasticsearch 7.17. The remainder of the text still mentions 8.6.1, to stay true to what we actually did under Windows.

  • Unpack official windows release file elasticsearch-8.6.1-windows-x86_64.zip

    Other Versions should also be fine. This is true for all the below mentioned tools.

  • Disable security with ...

xpack.security.enabled: false

... in elasticsearch-8.6.1\config\elasticsearch.yml

  • Unpacked into elasticsearch-8.6.1\plugins\analysis-icu\ (no further subfolders).

  • Start, for example in a Windows powershell:

.\elasticsearch-8.6.1\bin\elasticsearch.bat

Elasticsearch then used the default address http://localhost:9200, which is also configured in fylr.yml.

Start fylr with minimal dependencies

Edit fylr.yml to not use any 3rd part tools for the moment if you want to test/start with minimal effort:

 fylr+:
  [...]
  services+:
  [...]
    execserver+:

      commands:
        fylr:
          prog: fylr.exe
      services:

You are now ready to start fylr, although most asset processing tools are still missing: (no previews)

.\fylr.exe server -c fylr.yml

... in the folder where fylr.exe is.

Output lines with WRN can usually be ignored.

Harmless Errors known to appear are e.g.

  • Error occurred in NewIntrospectionRequest and Accepting token failed, when a browser tries to use old credentials.

Access the web frontend

Default login credentials are:

  • Username: root

  • Password: admin

More than bare bone minimum

For a full installation it is recommended to install all of the following and un-comment them in fylr.yml.

"Un-comment" = turning the comments into configuration.

PostgreSQL

  • We started pgadmin and created a role "fylr" (with LOGIN and INHERIT, the defaults), with password "fylr"; and a database "fylr" owned by role "fylr".

  • We un-commented these lines in fylr.yml:

    driver: postgres
    dsn: "host=localhost port=5432 user=fylr password=fylr dbname=fylr sslmode=disable"
  • And we disabled the lines configuring sqlite, by turning them into comments:

    #driver: sqlite3
    #dsn: "data\\sqlite.db"
  • For a consistent state we also did the next step: cleanup.

cleanup

If you want to go back to a fresh state between two test runs:

  • Stop fylr.exe and the indexer (opensearch or elasticsearch). Optionally check that java / openjdk is stopped alongside elasticsearch.

  • Remove the directory data and elasticsearch's data/* .

  • Start elasticsearch as shown at the beginning.

  • If you use PostgreSQL, remove and recreate the database.

pdf tools

  • We unpacked its contents and configured the path to pdftotext.exe, pdftoppm.exe and pdfinfo.exe in fylr.yml. Alternatively, we tested successfully to add the containing directory of those tools to the PATH.

magick.exe and convert.exe and composite.exe

  • We put the three mentioned tools from the download into C:\fylr\utils.

If you have any problems, you likely need vcomp120.dll. To install it, download Visual C++ Redistributable Package(https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads).

Exiftool.exe

We have put exiftool(-k).exe from the download into C:\fylr\utils.

We renamed it to exiftool.exe as recommended on exiftool.sourceforge.net.

Ffmpeg.exe and ffprobe.exe

We suggest you avoid the LGPL version as testing showed it has less features (x264 and x265).

We have put ffmpeg.exe and ffprobe.exe into C:\fylr\utils.

Node

We put just node.exe into C:\fylr\utils.

Python

We unpacked the whole package as the folder "python3" inside C:\fylr\utils.

Java

For extracting information from assets, fylr needs a "java" command. We made sure to have java installed and that it can be started by the command java (for that, it has to be in the system environment variable PATH, which already was the case after java installation).

Saxon

This replaces xsltproc in fylr v6.19.

  • The unpacked file was C:\fylr\utils\saxon\saxon-he-12.5.jar .

fylr+:
  services+:
    execserver+:
      commands:
        saxon:
          prog: java
          args:
            - "-jar"
            - "C:\\fylr\\utils\\saxon\\saxon-he-12.5.jar"

Ghostscript

We installed to C:\Program Files\gs\gs10.05.0 .

The bin directory was added automatically to the system %PATH% by the Ghostscript installer.

We then copied gswin64c.exe to gs.exe so that other programs are able to find it in %PATH%.

PS C:\Program Files\gs\gs10.05.0\bin> dir
Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a----    Mi, 12.03.2025     13:58          93696 gs.exe
-a----    Mi, 12.03.2025     13:58          93696 gswin64c.exe

We also added to the system path: C:\Program Files\gs\gs10.05.0\lib.

Libreoffice

and configured in fylr.yml:

fylr+:
  services+:
    execserver+:
      commands:
        soffice:
          prog: "C:\\Program Files\\LibreOffice\\program\\soffice.exe"

Fair warning: If you make your installation path too long, libre office will not work.

Example for too long: C:\Users\Klaus Thorn\Desktop\pf\fylr_v6.2.4_windows_amd64\utils\LibreOfficePortable\.

We then configured the path to soffice.exe in fylr.yml.

Inkscape

We installed Inkscape 1.4 via its default Installer.

Version 1.4 is needed for the generation of previews for .eps-files via ps2pdf and inkscape.

We added Inkscape's bin directory to the Windows System %PATH% like this:

  1. In the Windows Start Menu, we typed env, then selected Edit the system environment variables

  2. We clicked the Environment Variables... button

  3. In the lower section titled System variables , we selected the line starting with Path.

  4. We clicked Edit...

  5. In the new window, we clicked New and pasted C:\Program Files\Inkscape\bin .

  6. We clicked OK.

  7. We closed and opened a new window for fylr.exe so that the new %PATH% is known to the window and thus to fylr.

We tested Inkscape integration by uploading a svg file into fylr and check whether a preview is generated.

tika

We configured in fylr.yml:

fylr+:
  services+:
    execserver+:
      commands:
        tika:
          prog: java
          args:
            - "-jar"
            - "C:\\fylr\\utils\\tika-app-2.9.2.jar"

tesseract

  • In the installer dialogs we chose all languages and script data

  • We installed to C:\fylr\utils\tesseract

  • We configured in fylr.yml:

fylr+:
  services+:
    execserver+:
      commands:
        tesseract:
          prog: "C:\\fylr\\utils\\tesseract\\tesseract.exe"

mupdf tools

In fylr.yml we configured:

fylr+:
  services+:
    execserver+:
      commands:
        mutool:
          prog: "C:\\fylr\\utils\\mupdf\\mutool.exe"

dot

calibre

chrome

Optional. Only needed for the plugin called server-pdf in the plugin manager. this plugin is not packaged with fylr by default. We mention it here to show the config under Windows as an example.

  • Install the browser Chrome

  • configure the location of chrome in fylr.yml:

fylr+:
  env:
    SERVER_PDF_CHROME: "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"

Configure the tools in fylr.yml

Here is how to configure all these tools in fylr.yml:

  • before, the tools in fylr.yml look like this (minimal, no 3rd party tools):

fylr+:
  [...]
  services+:
  [...]
    execserver+:

      commands:
        fylr:
          prog: fylr.exe
      services:
      
  • after we have added the tools: (remember to instead use paths valid on your installation)

fylr+:
  env:
    SERVER_PDF_CHROME: "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
  [...]
  services+:
  [...]
    execserver+:
      commands:
        fylr:
          prog: fylr.exe
        # ffmpegthumbnailer: not under Windows. ffmpeg is used instead as a fallback
        soffice:
          prog: "C:\\LibreOfficePortable\\LibreOfficePortable.exe"
        magick:
          prog: "C:\\fylr\\utils\\magick.exe"
        exiftool:
          prog: "C:\\fylr\\utils\\exiftool.exe"
        ffmpeg:
          prog: "C:\\fylr\\utils\\ffmpeg.exe"
        ffprobe:
          prog: "C:\\fylr\\utils\\ffprobe.exe"
        node:
          prog: "C:\\fylr\\utils\\node.exe"
        python3:
          #prog: "C:\\fylr\\utils\\python3\\python.exe"
          # is searched in PATH variable:
          prog: "python.exe"
        pdftotext:
          prog: "C:\\fylr\\utils\\poppler-pdf\\Library\\bin\\pdftotext.exe"
        pdfinfo:
          prog: "C:\\fylr\\utils\\poppler-pdf\\Library\\bin\\pdfinfo.exe"
        java:
          prog: java.exe
        inkscape:
          prog: inkscape.exe
        saxon:
          prog: java
          args:
            - "-jar"
            - "C:\\fylr\\utils\\saxon\\saxon-he-12.5.jar"
        dot:
          prog: "C:\\fylr\\utils\\Graphviz\\bin\\dot.exe"
        tika:
          prog: java
          args:
            - "-jar"
            - "C:\\fylr\\utils\\tika-app-2.9.2.jar"
        tesseract:
          prog: "C:\\fylr\\utils\\tesseract\\tesseract.exe"
        mutool:
          prog: "C:\\fylr\\utils\\mupdf\\mutool.exe"
        ebook-meta:
          prog: "C:\\fylr\\utils\\Calibre2\\ebook-meta.exe"
        ebook-convert:
          prog: "C:\\fylr\\utils\\Calibre2\\ebook-convert.exe"

Check that each indentation level is two spaces. (No tab characters, just space characters).


Start fylr as a service

After testing, you may want to switch to

fylr.exe server -c fylr.yml --service install

We installed OpenSearch as described in

Download from

Got the analysis-icu plugin from for offline installation (it was https://artifacts.elastic.co/downloads/elasticsearch-plugins/analysis-icu/analysis-icu-8.6.1.zip)

Browse

We installed 15.2 from

We downloaded from (not xpdf-tools from https://www.xpdfreader.com)

We downloaded ImageMagick-7.1.0-61-portable-Q16-HDRI-x64.zip from

Hint from the :

We downloaded: Windows Executable: exiftool-12.56.zip on

We downloaded ffmpeg-n5.1.2-12-g7268323193-win64-gpl-5.1.zip from

We downloaded node-v16.17.0-win-x64.7z from

We donwloaded "Windows embeddable package (64-bit)" at (explained )

We downloaded SaxonJ-HE 12.5 from

We downloaded Ghostscript 10.05.0 for Windows (64 bit) from

The latter is needed for the generation of previews for .eps-files via ps2pdf and .

We installed LibreOffice ()

As an alternative we successfully tested LibreOfficePortable_7.4.5_MultilingualStandard.paf.exe from to C:\LibreOfficePortable.

We downloaded from the jar file tika-app-2.9.2.jar.

From we downloaded and started the installer tesseract-ocr-w64-setup-5.5.0.20241111.exe (64 bit)

We downloaded mupdf-1.25.2-windows.zip from and unpacked it into C:\fylr\utils\mupdf\ .

from

from

If you have at least version 1.1.0 of the plugin: it is ready for fylr under Windows.

To update the plugin automatically, use this URL:

https://attention.dk/docs/att/doku.php?id=winfylr:start
https://docs.fylr.io/releases
length limit
https://opensearch.org/docs/latest/install-and-configure/install-opensearch/windows/
https://www.elastic.co/guide/en/elasticsearch/reference/current/zip-windows.html
https://www.elastic.co/guide/en/elasticsearch/plugins/current/analysis-icu.html
http://localhost
https://www.enterprisedb.com/downloads/postgres-postgresql-downloads
Release-23.08.0-0.zip
https://github.com/oschwartz10612/poppler-windows
https://imagemagick.org/script/download.php#windows
download page
http://exiftool.sourceforge.net
https://github.com/BtbN/FFmpeg-Builds/releases
https://nodejs.org/dist/v16.17.0/
https://www.python.org/downloads/windows/
here
https://www.saxonica.com/download/java.xml
https://ghostscript.com/releases/gsdnld.html
https://de.libreoffice.org/donate/dl/win-x86_64/24.8.4/de/LibreOffice_24.8.4_Win_x86-64.msi
https://www.libreoffice.org/download/portable-versions/
https://tika.apache.org/download.html
https://github.com/UB-Mannheim/tesseract/wiki
https://mupdf.com/releases
https://www.graphviz.org/download/
https://calibre-ebook.com/download_windows
https://github.com/programmfabrik/fylr-plugin-server-pdf/releases/tag/v1.1.0
https://github.com/programmfabrik/fylr-plugin-server-pdf/releases/latest/download/fylr-plugin-server-pdf.zip
inkscape