Installation

Alfred Finder can be run as a Docker container, or can be installed on a webserver.

Pre-requisites

Alfred Finder requires Alfred API, version 2.7.1 or later. This module should be installed in Alfresco before Alfred Finder can be used. Installation instructions can be found in the Alfred API documentation.

Installation with a Docker container

When Alfresco is installed in a Dockerized environment with a proxy in front of Alfresco, the easiest way to get started is by deploying a separate Docker container with Alfred Finder.

The Alfred Finder Docker image is available on docker.xenit.eu/alfred-finder/finder-app:<version>.

The Docker image contains a webserver that serves the Alfred Finder application on /.

It is recommended that the proxy is configured to forward traffic with prefix /finder/ (or a different prefix if desired) to the Alfred Finder container.

The serviceUrl environment variable can be modified to change the location of the Alfresco repository if it is configured on a different hostname or context. The default configuration assumes that the Alfresco repository is accessible on the same hostname with base-path /alfresco/.

Note: In case the Alfresco repository is configured on a different hostname, correct Cross-Origin Resource Sharing (CORS) headers MUST be configured to allow Alfred Finder to access and authenticate against the Alfresco repository.

Installation on a webserver

Alfred Finder can also be installed on a separate webserver.

This approach allows for installing multiple instances with different configuration for the same Alfresco repository.

Alfred Finder is a static web application without server-side programming. It is sufficient to extract the Alfred Finder ZIP to a folder that is configured as a subfolder of the document root in the webserver.

The Alfred Finder ZIP can be obtained from the Xenit Cloudsmith private repository, in the eu.xenit.finder:finder-app:<version>:zip:static module.

The resources/static/config.js file can be modified to change the serviceUrl in case the Alfresco repository is configured on a different hostname or context.

Note: In case the Alfresco repository is configured on a different hostname, correct Cross-Origin Resource Sharing (CORS) headers MUST be configured to allow Alfred Finder to access and authenticate against the Alfresco repository.