FileRun installation using Docker

1. Install Docker

Please see https://docs.docker.com/engine/install/

2. Create the FileRun "docker-compose.yml" file

Create a text file named docker-compose.yml:

 1vim docker-compose.yml

and paste the following inside, adjusting the settings accordingly to your needs:

 1services:
 2  db:
 3    image: mariadb:10.1
 4    environment:
 5      MYSQL_ROOT_PASSWORD: your_mysql_root_password
 6      MYSQL_USER: your_filerun_username
 7      MYSQL_PASSWORD: your_filerun_password
 8      MYSQL_DATABASE: your_filerun_database
 9    volumes:
10      - /filerun/db:/var/lib/mysql
11
12  web:
13    image: filerun/filerun:8.1
14    environment:
15      FR_DB_HOST: db
16      FR_DB_PORT: 3306
17      FR_DB_NAME: your_filerun_database
18      FR_DB_USER: your_filerun_username
19      FR_DB_PASS: your_filerun_password
20      APACHE_RUN_USER: www-data
21      APACHE_RUN_USER_ID: 33
22      APACHE_RUN_GROUP: www-data
23      APACHE_RUN_GROUP_ID: 33
24    depends_on:
25      - db
26    links:
27      - db:db
28    ports:
29      - "80:80"
30    volumes:
31      - /filerun/html:/var/www/html
32      - /filerun/user-files:/user-files

Please note the above volumes configuration. There are two folders you need to configure.

One for the FileRun application files (it can be located in any empty folder and must have the mount path set to /var/www/html) and one for the FileRun user files, with the mount path set to /user-files.

In other words, if you use the above configuration text as it is, you just need to create two empty folders, /filerun/html and /filerun/user-files and you can start the FileRun Docker container up:

 1mkdir /filerun /filerun/html /filerun/user-files /filerun/db

3. Download and place the FileRun application files

Login to your FileRun client account.

From the page Your Licenses, you can download the FileRun application files in a zip archive.

Please use the version for PHP 8.1 with this Docker image.

Upload the zip archive to your server, inside where you mounted /var/www/html (for our above example, that would be /filerun/html).

Extract the zip in the same folder.

Adjust the folder permissions to be writable by FileRun:

 1chown www-data:www-data -R /filerun/html/system/data
 2chown www-data:www-data -R /filerun/user-files

4. Start the containers

And start FileRun up using the following command:

 1docker compose up -d

FileRun is now ready, and you can access it with your browser.

After completing the web-based installation

You will want to set the home folder path of the FileRun Superuser account to /user-files

Please note that LibreOffice path is /opt/libreoffice7.5/program/soffice

SSL/HTTPS

Please see this guide.

Troubleshooting Desktop resync

If your desktop sync app redownload everything every time your server restarts, it may be because your Docker container is changing the device ID of the volume mounts. To fix this, please use the option

 1$config['system']['webdav']['skip_device_id_for_etag'] = true;

See this page.